Labels and Statuses
This document describes appointment marks (labels and statuses) you can use to graphically identify appointments in their schedules. By default, labels and statuses collections contain items that are similar to the corresponding marks of Microsoft Outlook, and can be used to bring the Outlook style to your scheduling application. However, you can create your own custom labels and statuses.
Appointment Labels
A label is one of the basic visual characteristics of an appointment. It is used for at-a-glance appointment identification. In a scheduler, a label is displayed as a background colour that fills the rectangle that represents an appointment.
The following picture illustrates what appointments with different labels look like. The label information is displayed as the appointment's description.
By default the Labels collection is filled with the following labels.
|
Color
|
ARGB Color Value
|
Display Name
|
LabelId
|
 |
System.Drawing.SystemColors.Window
|
None
|
0
|
 |
#FFFFC2BE
|
Important
|
1
|
 |
#FFA8D5FF
|
Business
|
2
|
 |
#FFC1F49C
|
Personal
|
3
|
 |
#FFF3E4C7
|
Vacation
|
4
|
 |
#FFF4CE93
|
Must Attend
|
5
|
 |
#FFC7F4FF
|
Travel Required
|
6
|
 |
#FFCFDB98
|
Needs Preparation
|
7
|
 |
#FFE0CFE9
|
Birthday
|
8
|
 |
#FF8DE9DF
|
Anniversary
|
9
|
 |
#FFFFF7A5
|
Phone Call
|
10
|
Appointment Statuses
Availability status is one of an appointment's visual characteristics (marks). It is used for at-a-glance appointment identification. The status can be indicated as a strip painted with a particular brush and displayed in the appointment's rectangle - on the left side or at the top. The status brush can also be used to paint the time cell background for all-day appointments if the StatusDisplayType property is set to the TimeCell value, as illustrated in the following picture:
The Statuses collection contains the following predefined items:
|
Standard Brush
|
Standard ARGB Color Value
|
Display Name
|
StatusId
|
|
|
#FFFFFFFF
|
Free
|
0
|
 |
#FF4A87E2
|
Tentative
|
1
|
 |
#FF4A87E2
|
Busy
|
2
|
 |
#FF800080
|
Out Of Office
|
3
|
 |
#FF937BD1
|
Working Elsewhere
|
4
|
The color of status brushes used to paint the time cell background for an appointment with the AppointmentStatusType.Busy, AppointmentStatusType.Tentative and AppointmentStatusType.WorkingElsewhere statuses is the colour of the appointment label. The time cell background for an appointment with the AppointmentStatusType.OutOfOffice status always has the standard color of this status. If the appointment has the label 'None' with ID=0 (e.g. a newly created appointment), the status uses standard colors listed in the table above.
The default values for the Statuses collection items are the same as availability statuses in MS Outlook. However you can edit this collection and customize the existing statuses, remove them, or add your own custom ones. This can be done both at design time and runtime.