![]() ![]() ![]() ![]() Gravitybox Schedule Primer
Page 73
1998-2004 Gravitybox Software LLC
one preferred by much of Europe and will receive a warmer reception there than the
American 12-hour format.
HeaderDateFormat
This is a most useful property. When deploying a scheduling application around the
world, each country insists on its own date format. This property determines the format
of the date displayed in the header of each day. This property is also useful to
customize the date display, even if the application is never deployed over seas. Line
breaks may be specified as well to display any type of custom format.
ImageList and IconAlign
The schedule has a property ImageList that may be set to a valid reference of a
Microsoft Common Controls ImageList. This ImageList may contain icons that you wish
to associate with an appointment. First add the icons you wish to use and make sure
that each icon has a its key property value set. The images look best if they are 16x16
and the ImageLists UseMaskColor property is set to true. Each appointment has an
Icons collection that may be used to display custom icons with an appointment. To
specify icons just call the collections Add method with the icon key you wish to use. If
the key is not valid it is just skipped when displaying icons on the schedule canvas. No
ruin-time error occurs. When drawing an appointment, if the schedule finds a valid
ImageList and one of its icons ha a key that matches a key in the Icons collection, the
associated icon is drawn on the appointment. You may specify any number of icons for
an appointment. Icons that do not fit on the appointment will not be displayed at al. This
is a limitation of small appointments. The appointment square is only so big and if you
specify 100 icons, all of them will probably not fit. This brings up another property,
IconAlign. Icons may be displayed on the left or top of the appointment text. You may
decide based on whichever looks the best for your situation.
CategoryBar
Even though Category objects have been defined in the Categories collection, their
display may not be needed. The CategoryBar property will allow for the selective display
of defined categories so that they may or may not be displayed in the left margin. The
associated mapped colors may still be displayed on the appointments margin by setting
the AppointmentCategoryBar property to true.
Note: If category bar margin on the left is desired to be as small as possible, set the
DisplayName of the Categories collection to empty string. The margin is the smaller
width of this caption or the summation of the bar widths. Setting the caption to have a
zero width ensures that just enough space to display the category bars is used.
|