A newer version of this page is available. Switch to the current version.

AppointmentLabelItem.Color Property

Gets or sets the appointment label‘s color.

Namespace: DevExpress.Xpf.Scheduling

Assembly: DevExpress.Xpf.Scheduling.v20.2.dll


public Color Color { get; set; }

Property Value

Type Description

A Color value which represents the color used for an appointment label.



The Brush property is the recommended method to assign colors to labels. The Brush property overrides the Color property. Refer to the Customize Colors topic for more information.

The Color property defines the appointment color and has the highest priority. If you set this property (either directly or by mapping), the SchedulerControl.LabelColors setting is ignored.

If you do not use the Color property, the Scheduler control takes a label color from the SchedulerControl.LabelColors palette.

You can set SchedulerControl.LabelColors directly for all themes:


An alternative approach is to override the label colors palette for a certain theme. To do this, use the DevExpress.Xpf.Scheduling.Themes.SchedulerThemeKeys.LabelColors and DevExpress.Xpf.Scheduling.Themes.SchedulerThemeKeys.LabelColors_Classic resource keys. The SchedulerThemeKeys.LabelColors_Classic resource key is only used in the Classic scheduler appearance style:

<dxsch:ColorCollection x:Key="{dxscht:SchedulerThemeKey ResourceKey=LabelColors, ThemeName=Office2019Colorful}">

If the Color property is set to Colors.Transparent, the appointment color is taken from the assigned resource item. If appointment has several assigned resources and SchedulerControl.GroupType is None, the appointment has the default theme background.

See Also