Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
  [Expand]Reporting
  [Expand]Chart Control
  [Expand]Grid View
  [Expand]Card View
  [Expand]Vertical Grid
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Image and Data Browsing
  [Expand]Docking and Popups
  [Expand]Site Navigation and Layout
  [Expand]File Management
  [Expand]Multi-Use Site Controls
  [Collapse]Scheduler
   [Expand]Product Information
    Getting Started
   [Expand]Fundamentals
   [Collapse]Concepts
    [Expand]Scheduler Elements
    [Collapse]Appointments
      What Is an Appointment
      Appointment Labels and Statuses
      Recurring Appointments and Exceptions
      Reminders for Appointments
    [Expand]Resources
    [Expand]Views
     Data Binding
    [Expand]Services
     Adaptivity
     Templates
     Client-Side Functionality
     Callback Commands
    [Expand]Reporting
     Time Zones
     Keyboard Shortcuts
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]HTML Editor
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gauges
  [Expand]Data Editors
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Appointment Labels and Statuses

This document describes the appointment marks (labels and statuses) which can be used by end-users to graphically mark the appointments in their schedule. By default, the labels and status collections contain marks which are equal to the corresponding marks in MS Outlook, and can be used to bring the Outlook style to your scheduling application. However, you can create your own custom labels and statuses and mark appointments with them. This document provides several examples.

Expanded Appointment Labels

An appointment's identification label is one of an appointment's basic visual characteristics (marks). It is used for at-a-glance appointment identification. The appointment's identification label is displayed in the scheduler as a background color which is used to fill the client region of the rectangle that is occupied by the appointment.

The following picture gives an overview of what different labeling looks like.

An individual label is represented by the AppointmentLabel objects. The label's display name and color can be accessed via its UserInterfaceObject.DisplayName and AppointmentLabel.Color properties, and all the labels are stored in the ASPxAppointmentStorage.Labels collection.

By default, the Labels collection is filled with the following labels:

The default values for the Labels collection items corresponds to the labels in MS Outlook 2003. However, you're able to edit this collection and customize the existing labels, remove them and add your own custom ones. This can be done both at design time and runtime.

To mark an appointment with a specified label at runtime use the Appointment.LabelKey property:

Note

You can handle the ASPxScheduler.InitNewAppointment event to initialize all the newly created appointments with the specified label.

Expanded Appointment Statuses

The appointment's availability status is one of an appointment's basic visual characteristics (marks). It is used for at-a-glance appointment identification. The appointment's availability status is indicated in the scheduler as a strip displayed on the left side of the appointment. The strip is colored depending upon the availability status's type.

Note

Availability statuses are only visible when the scheduler is in the Day View or Work-Week View.

An individual status is represented by the AppointmentStatus objects. The status's display name and color can be accessed via its UserInterfaceObject.DisplayName and AppointmentLabel.Color properties, and all the statuses are stored in the ASPxAppointmentStorage.Statuses collection.

By default, the Statuses collection is filled with four statuses, presented in the picture above.

The default values for the Statuses collection items corresponds to the availability statuses in MS Outlook 2003. However, you're able to edit this collection and customize the existing statuses, remove them or add your own custom ones. This can be done both at design time and runtime.

To mark an appointment with the specified availability status at runtime, use the Appointment.StatusKey property.

Note

You can handle the ASPxScheduler.InitNewAppointment event to initialize all the newly created appointments with the specified availability status.

How would you rate this topic?​​​​​​​