SECCalendar implements a standard calendar control for date entry and date representation. You can invoke methods to highlight and select days on the calendar. You can embed an SECCalendar instance into a dialog or implement it as a pop-up control through the derived class SECPopupCalendar. SECPopupCalendar allows the user to view the calendar control as a drop-down window, which saves screen space.
The calendar class hierarchy is as follows:
Create an instance of SECCalendar or SECPopupCalendar.
Call the SetPage() method to display the appropriate month for a given date. For 32-bit versions of Objective Toolkit, pass in either a COleDateTime reference or a CTime reference. For example:
COleDateTime date = COleDateTime::GetCurrentTime();
// bRedraw MUST be FALSE when presetting a page.
m_theCalendar.SetPage(date, FALSE);
|
Call the SetBehaviorMode() and SetDrawMode() methods. For example:
long lBehaMode = SECBM_DEFAULT_DIALOG_BEHAVIOR;
long lDrawMode = SECDM_DEFAULT_DIALOG_DRAW;
m_theCalendar.SetBehaviorMode(lBehaMode);
m_theCalendar.SetDrawMode(lDrawMode);
|
Call the Create() method. For example:
m_theCalendar.Create( WS_VISIBLE|WS_BORDER,
rect, this, IDC_CALENDAR_FRAME );
|
SetDrawMode(). Sets the drawing mode of the calendar with the flags specified in the following table.
| Draw Flag | Description |
| SECDM_FULL_MONTH_NAMES | Uses full month names. |
| SECDM_FULL_DAY_NAMES | Uses full day names. |
SetBehaviorMode(). Sets the behavior mode of the calendar with the flags specified in the following table:
| Behavior Flag | Description |
| SECBM_AUTOSIZE_FONT | Automatically scales the font to fit the current size of the control. |
| SECBM_AUTOSIZE_RECT | Automatically scales the calendar's bounding rectangle to fit the parent window. |
| SECBM_SINGLE_DATE | Allows the user to select a single date. |
| SECBM_MONTH_BUTTONS | Displays the buttons to scroll months. |
| SECBM_YEAR_BUTTONS | Displays the buttons to scroll years. |
| SECBM_AUTO_HIDE | Hides the calendar automatically when the user is done. |
| SECBM_KEYBOARD_CONTROL | Allows navigation of the calendar with the keyboard. |
| SECBM_MONTH_FROZEN | Freezes the currently displayed month. |
SetPage(). Sets the displayed calendar page based on the CTime or COleDateTime parameter passed in.
HighlightDate(). Sets the highlighted mode of the specified date. Multiple dates can be highlighted at one time.
SelectDate(). Selects the date based on the CTime or COleDateTime parameter passed in. The user can only select one date at any given time.
ToggleSelectDate(). Toggles the selected mode of the specified date.
ToggleHighlightDate(). Toggles the highlighted mode of the specified date. Multiple dates can be highlighted at one time.
AdvanceDay(), AdvanceWeek(), AdvanceMonth(), AdvanceYear(). Advances the calendar by the given amount.
RetreatDay(), RetreatWeek(), RetreatMonth(), RetreatYear(). Retreats the calendar by the given amount.
Most of the SECCalendar operation methods (AdvanceDay(), AdvanceWeek(), AdvanceMonth(), and more) are virtual functions that you can override to add custom behavior to a derived class. In addition, you can override the InitColors() method to specify colors for the various parts of the calendar. The default implementation initializes the colors based on the current system colors.
The use of SECCalendar and SECPopupCalendar is demonstrated in the caltest sample in the Samples\Toolkit\MFC\Controls\calendar directory. This sample is not shipped with the product. For information on how to obtain this sample, see Section 3.6.1, "Location of Sample Code," in the Stingray Studio Getting Started Guide.
Copyright © Rogue Wave Software, Inc. All Rights Reserved.
The Rogue Wave name and logo, and Stingray, are registered trademarks of Rogue Wave Software. All other trademarks are the property of their respective owners.
Provide feedback to Rogue Wave about its documentation.