A label is simply a color-coded marker that can be added to appointments so that you and others know what type of appointment it is without even having to view its details. There are twelve predefined labels available in Scheduler. The color of the label is visible in every data view in the Scheduler control.

Labels can be set for any appointment at design time by selecting the desired label from the Label dropdown in the Appointment dialog as showcased in the image below.

Predefined Labels

The predefined labels include the following:

To add a label associated to an appointment programmatically, you can use Label property of the Appointment class and set its index (from the above table) based on your requirements. For instance, the following code demonstrates how you can add "Important" label to an appointment:

//Showing Labels
// adding 'Important' label.
appointment.Label = scheduler.DataStorage.LabelStorage.Labels[1];

Custom Labels

Predefined labels are fixed categories that are already available within the Scheduler control. However, you can also create your own set of labels (or custom labels) to display specific information instead of predefined labels in the scheduler control.

With the Scheduler control, you can bind labels and availability statuses to your own custom collections easily. Custom labels override the predefined labels and appear in the Scheduler control on binding. To bind custom labels with the Scheduler control, you need to create a class that provides custom labels. Perform the following steps to create and bind your custom labels collection with the Scheduler control:

1. Create a class with the name Label in the code-behind file and define the Text, Color and Index properties in it:

   CS	Copy Code
   public class Label { public int Index { get; set; } public string Text { get; set; } public string Color { get; set; } }

2. Initialize a collection with the name Labels of List datatype which holds instances of the Label class. The collection then adds a new Label object to this list with specific values of properties:

   CS

   Copy Code

   this.Labels = new List<Label>(); this.Labels.Add(new Label { Text = "None", Color = "255,0,128,128", Index = 1 }); this.Labels.Add(new Label { Text = "Weekly meet", Color = "255,0,255,255", Index = 2 }); this.Labels.Add(new Label { Text = "Fortnight meet", Color = "255,0,255,128", Index = 3 }); this.Labels.Add(new Label { Text = "Monthly meet", Color = "255,0,0,255", Index = 4 }); this.Labels.Add(new Label { Text = "Semi-annual meet", Color = "255,255,0,0", Index = 5 }); this.Labels.Add(new Label { Text = "Annual meet", Color = "255,255,255,0", Index = 5 });

3. In the XAML view, add four property setters with the name NestedPropertySetter within <c1:C1Scheduler></c1:C1Schedule> tags to bind and map the Labels collection with the C1Scheduler control.

   XAML

   Copy Code

   <c1:NestedPropertySetter PropertyName="DataStorage.LabelStorage.DataSource" Value="{Binding Path = Labels}" /> <c1:NestedPropertySetter PropertyName="DataStorage.LabelStorage.Mappings.TextMapping.MappingName" Value="Text"/> <c1:NestedPropertySetter PropertyName="DataStorage.LabelStorage.Mappings.ColorMapping.MappingName" Value="Color"/> <c1:NestedPropertySetter PropertyName="DataStorage.LabelStorage.Mappings.IndexMapping.MappingName" Value="Index"/>

4. Run the application and click the Label drop-down list to select a custom label, as shown in the following figure: