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.v19.1.dll

Declaration

public Color Color { get; set; }
Public Property Color As Color

Property Value

Type Description
Color

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

Remarks

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:

 <dxsch:SchedulerControl.LabelColors>
    <Color>Transparent</Color>
    <Color>Red</Color>
</dxsch:SchedulerControl.LabelColors>

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}">
    <Color>Transparent</Color>
    <Color>Red</Color>
</dxsch:ColorCollection>

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