SchedulerDataStorage.LabelItems Property

Provides access to the collection of appointment labels.

Namespace: DevExpress.Maui.Scheduler

Assembly: DevExpress.Maui.Scheduler.dll

NuGet Package: DevExpress.Maui.Scheduler

Declaration

public AppointmentLabelItemCollection LabelItems { get; }

Property Value

Type	Description
AppointmentLabelItemCollection	A collection of appointment label items.

Remarks

Labels specify background colors of appointment rectangles. Users can assign labels to appointments to categorize and identify them.

A scheduler view holds its labels in the storage’s LabelItems collection. You can customize existing labels, remove them or add new ones. An individual label is an AppointmentLabelItem object. It provides the Caption and Color properties that you can use to specify a label’s display name and color.

To assign a particular label to an appointment, use the AppointmentItem.LabelId property.

Default Labels

A scheduler view provides the following predefined labels:

Color	Color Value	Display Name	Label Id (Int32 Value)
	#949494	None	0
	#F15558	Important	1
	#FF7C11	Business	2
	#FFBF22	Personal	3
	#FF6E86	Vacation	4
	#9865b0	Must Attend	5
	#756CFD	Travel Required	6
	#0055D8	Needs Preparation	7
	#01B0EE	Birthday	8
	#0097AD	Anniversary	9
	#00C831	Phone Call	10

Custom Labels

You can bind the scheduler to an external data source of labels. Use the DataSource.AppointmentLabelsSource property to specify a collection of custom label objects and then use the DataSource.AppointmentLabelMappings property to map the scheduler’s appointment label properties to the data source fields.

See the example How to: Create Custom Labels.