[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Member Tables
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Collapse]Scheduler
   [Expand]Product Information
    Getting Started
   [Expand]Scheduler Elements and Structure
   [Collapse]Data Binding
    [Expand]Data Sources
    [Collapse]Mappings
      Appointment Mappings
      Resource Mappings
      Dependency Mappings
      Label Mappings
      Status Mappings
      How to: Set Mappings
      Custom Fields
      Mapping Converters
     FetchAppointments Event - Handling Large Datasets
   [Expand]Appointments
   [Expand]Views
   [Expand]Import and Export
    Printing
   [Expand]Reports
   [Expand]Time Zones
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
   [Expand]Services
   [Expand]Member Tables
   [Expand]Visual Elements
   [Expand]Examples
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Label Mappings

The table below lists Mappings for Labels.

Name

Type

Required?

Description

LabelMappingInfo.Id

Object (any type)

Yes

The unique Label ID. Specifies the UserInterfaceObject.Id property value.

LabelMappingInfo.Color

See description

No

The Label's background color. Specifies the AppointmentLabel.Color property value. The SchedulerDataStorage.Labels.ColorSaving property value should correspond to the Color field's value type.

  • ColorSaving equals Auto: A data field mapped to the LabelMappingInfo.Color property can store values of any supported type. A correct value type is determined automatically.
  • ColorSaving equals ColorInstance: A data field mapped to the LabelMappingInfo.Color property must store System.Drawing.Color type values.
  • ColorSaving equals ColorString: A data field mapped to the LabelMappingInfo.Color property must store string values that specify colors in the hexadecimal format (e.g., "0xFFFF0000" for red).
  • ColorSaving equals OleColor: A data field mapped to the LabelMappingInfo.Color property must store OLE_Color values.
  • ColorSaving equals ArgbColor: A data field mapped to the LabelMappingInfo.Color property must store 32-bit ARGB values (integer values in the "AARRGGBB" format, e.g. "-65536" for red). You can retrieve integer ARGB values using the Color.ToArgb method.

LabelMappingInfo.DisplayName

String

No

The primary Label name. Specifies the UserInterfaceObject.DisplayName property value. Displayed in the Edit Appointment dialog.

LabelMappingInfo.MenuCaption

String

No

The secondary Label name. Specifies the UserInterfaceObject.MenuCaption property value. Displayed in the "Label As" appointment context menu item.

If this property is not mapped, the "Label As" menu shows no item captions.

You can map the MenuCaption and DisplayName properties to the same data source field.

Is this topic helpful?​​​​​​​