Skip to main content

SchedulerDataStorage.LabelItems Property

Provides access to the collection of appointment labels.

Namespace: DevExpress.XamarinForms.Scheduler

Assembly: DevExpress.XamarinForms.Scheduler.dll

NuGet Package: DevExpress.XamarinForms.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)

None

#949494

None

0

Important

#F15558

Important

1

Business

#FF7C11

Business

2

Personal

#FFBF22

Personal

3

Vacation

#FF6E86

Vacation

4

Must Attend

#9865b0

Must Attend

5

Travel Required

#756CFD

Travel Required

6

Needs Preparation

#0055D8

Needs Preparation

7

Birthday

#01B0EE

Birthday

8

Anniversary

#0097AD

Anniversary

9

Phone Call

#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.

See Also