Navigation bar
  Home Print document Start Previous page
 121 of 234 
Next page End  

Gravitybox Schedule Primer
Page 119 
1998-2004 Gravitybox Software LLC
ScheduleRecurrence Control
The ScheduleRecurrence control may be used to construct a custom screen for
recurring appointments. You may use the object model to add recurring appointments,
but this control and the default dialog of the schedule control allows for the addition of
this functionality to any application without any code. This functionality has been broken
out so that it may be used to build custom screen that may be displayed at some non-
standard place in an application.
Figure 13.2
 
 
The control has a ”CRecurrence” object as a property. You may use this to update the
any item of the GUI. The control also has a ScheduleItem property, which must be set
to an existing appointment for the control to display properly. The appointment
information at the top of the screen is the information provided by this ScheduleItem.
The bottom frame of the control that contains the range information for the recurrence is
set by properties of the Recurrence object.
The middle frame sets the actual information about the recurrence. This frame is
actually the settings of a collection of three different objects. The Recurrence object has
three sub object: RecurrenceDay, RecurrenceWeek, and RecurrenceMonth. The middle
frame of the control is the Recurrent Pattern settings. The settings displayed on the right
side of the frame determine in which radio button is selected: Daily, Weekly, or Monthly.
The properties of the underlying object are displayed when appropriate. For example if
the Daily radio button is selected, the right side will display two radio buttons. One will
allow the user to set the recurring pattern based on a day interval like every second day.
The other radio button will set the appointment to recur every weekday. The week and
month settings are displayed when their respective radio buttons are selected.
There are various customizations that may be performed on the control. For example, a
warning message may be displayed to the user to indicate some type of condition. The
IconWarning may be set to any icon desired and the WarningMessage property may be
http://www.purepage.com