![]() ![]() ![]() ![]() ![]() Gravitybox Schedule Primer
Page 132
1998-2004 Gravitybox Software LLC
The tabs on the right side of the control may be toggled on/off at your preference. By
default these are shown and allow the user an easy way to move to a desired position.
When the user presses a button, the first contact that starts with the buttons starting
letter is shown and selected. For example, if there is a tab with the caption pqr, the
first contact that starts with P will be selected. If there is no contact whose name starts
with the letter P, the first contact with a name greater than P will be selected. If the
next one in sequence is Herman Zimmerman, he will be selected when though the
pqr button was pressed.
The user may press the <F2> button to start an edit, if there is a selected item. The
events BeforeEditText and AfterEditText are executed in sequence, during this
operation. The former allows the user edit to be canceled if desired. The latter event
notifies you that the edit was successfully completed.
The user may display a property window by double-clicking
on the header of a Contact. Keep in mind that the AllowEdit
property must be set for this functionality to be present. The
property window displays some of the important properties
of a Contact. This screen is not configurable and if it does not meet your needs, you will
need to construct your own property screen. The phone numbers are auto-formatted to
the North American format.
Figure 13.6
This control also allows for file saving and loading. Just like
to TaskList and Schedule controls, it too has ImportXML
and ExportXML methods. They may be used instead of a
database to load and save the information in the contacts collection. When saving only
those properties with data will be saved. This saves space in the file. Since it would be
loaded empty string if saved empty string, there is no need to waste space with
placeholders in the XML file.
Quick Tip
You may cancel the default
properties screen by setting the
Cancel parameter to true in the
BeforeEdit event.
Quick Tip
You may define a custom phone
mask with the DefaultPhoneMask
property.
|