You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

The SRP DatePicker Control provides an easy and intuitive interface for selecting dates. The DatePicker displays any number of months simultaneously for quick access, and users can scroll to other months using scroll buttons or by clicking on any month header. Any number of dates can be selected continiously or non-continuously. Developers can give visual cues to their users by setting the font and colors of individual dates. The SRP DatePicker Control makes a great popup or date-by-date navigation tool. 

Prog IDSRP.DatePicker.1
Current Version3.0.5

Using SRP DatePicker Control

The following tutorials will familiarize you with the SRP DatePicker Control. These white papers take a topical approach to explaining how to use the control. New users should start here, since many of these topics will give a deeper understanding of the control and the philosophies behind its design. Once you've grasped these concepts, use the reference guides for details on particular properties, methods, and events.

TopicDescription
Date SelectionSelecting one or more dates in the date picker.
LayoutSetting the date picker presentation.
NavigationNavigating the date picker.

Properties

OLE control properties are the primary means of interacting with OLE controls. Properties, much like OI control properties, describe the persistent attributes of the control, that is, attributes having some meaningful value for the entire life of the control. Like OI control properties, OLE control properties are manipulated using the Get_Property and Set_Property routines. The following properties apply to the SRP DatePicker Control:

PropertyDescriptionVersion IntroducedPro Version Introduced
AutosizeDetermines if the control should decide the number of visible months based on its size.  
BorderThe control's border style.  
BorderColorsCustomizes the colors of an SRP ActiveX Control's border.3.0.33.1.0
DayOfWeekNamesThe displayed day of week names.  
DayStyleA day's font and color scheme.  
FirstDayOfWeekThe day of the week to appear on the left most column.  
FirstMonthThe first visible month.  
FirstWeekOfYearThe month and day that starts the first week of the year.  
FontThe font used to render the control.  
GridSizeThe number of visible months.  
HighlightTodayDetermines if today's date is identified by a colored border.  
MaxSelCountThe maximum number of selectable days.  
MonthDeltaThe number of months to scroll at a time.  
MonthNamesThe displayed month names.  
NoncontinuousSelectionDetermines if users can select non-continuous dates.  
NoneButtonVisibleShows or hides the None button.  
ProgIDThe control's ProgId/Class Name.  
RangeThe minimum and maximum allowable dates.  
RightToLeftDetermines if reading order is right-to-left.  
SelectionThe current selection.  
SelPosThe currently selected cell.  
ShowNonMonthDaysDetermines if the non month days appear in the first and last months.  
ShowWeekNumbersDetermines if week numbers appear to left of each month.  
ThemeThe visual theme.  
TodayButtonVisibleShows or hides the Today button.  
VersionThe control's version info.  

Methods

OLE control methods provide convenient one-time operations to developers. Unlike properties, whose values are persistant over the life of a control, methods represent actions that a control can perform. Often, methods will change the values of other control properties, so be sure to read the Remarks section of each method carefully. The following methods apply to the SRP DatePicker Control:

MethodDescriptionVersion IntroducedPro Version Introduced
EnsureVisibleBrings a date into view.  
EnsureVisibleSelectionBrings the selected date into view.  
ScrollLeftScroll's to previous months.  
ScrollRightScroll's to subsequent months.  
SetDayStylesSets any number of dates and date ranges to the same visual style.  
ShowContextMenuDisplays a context menu at the given mouse point.3.0.1 

Events

OLE control events provide a way for the OLE control to communicate back to OpenInsight. Once an event has been qualified using OI's QUALIFY_EVENT message, then the OLE control will fire the event to OpenInsight allowing you to respond to any one of the control's predefined actions. Some events allow you to stop certain actions before they occur, so be sure to read the Remarks section of each event carefully. The following events apply to the SRP DatePicker Control:

EventDescriptionVersion IntroducedPro Version Introduced
OnClickFires when the user clicks on the control.  
OnContextMenuClickFired when a menu item on the custom context menu is clicked3.0.1 
OnDblClickFires when the user double clicks on the control.  
OnGotFocusFired when the control receives input focus.3.0.33.1.0
OnLostFocusFired when the control loses input focus.3.0.33.1.0
OnMonthChangeFired when the months are scrolled.  
OnSelChangeFires when the user changes the selection.  
OnMouseEnterFired when mouse enters the control.3.0.33.1.0
OnMouseExitFired when the mouse leaves the control.3.0.33.1.0
  • No labels