AppointmentViewInfo.StatusDisplayType Property

Gets or sets whether the border of an appointment should be colorized according to the status and appointment duration.

Namespace: DevExpress.XtraScheduler.Drawing

Assembly: DevExpress.XtraScheduler.v19.1.dll

Declaration

C#

public AppointmentStatusDisplayType StatusDisplayType { get; set; }

VB.NET

Public Property StatusDisplayType As AppointmentStatusDisplayType

Property Value

Type	Description
AppointmentStatusDisplayType	An AppointmentStatusDisplayType enumeration specifying how the status is displayed.

Available values:

Name	Description
Never	The appointment status line is invisible.
Time	The appointment status line has the same height (if shown vertically) or width (if shown horizontally) as the time of its appointment.
Bounds	The appointment status line has the same height (if shown vertically) or width (if shown horizontally) as the appointment bounds.

Remarks

The StatusDisplayType property specifies how the status is displayed for a particular appointment. Subscribe to the SchedulerControl.AppointmentViewInfoCustomizing event and use the e.ViewInfo.StatusDisplayType notation.

Tip

To specify the status display type for all appointments, use the AppointmentDisplayOptions.StatusDisplayType property.

Example

This code illustrates how to handle the SchedulerControl.AppointmentViewInfoCustomizing event to change the AppointmentViewInfo.StatusDisplayType for an appointment whose Appointment.Description contains a particular string.

For better visibility, the DayViewAppointmentDisplayOptionsEx.ShowAllDayAppointmentStatusVertically property is set to false.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/winforms-schedulercontrol-api-t224044

AppointmentViewInfoCustomizingSamples.cs

    Appointment apt = scheduler.ActiveView.GetAppointments()[0];
    apt.End = apt.End.AddDays(1);
    apt.Description = "Time";
    scheduler.ActiveViewType = SchedulerViewType.Day;
    scheduler.DayView.AppointmentDisplayOptions.AllDayAppointmentsStatusDisplayType = AppointmentStatusDisplayType.Bounds;
    scheduler.DayView.AppointmentDisplayOptions.ShowAllDayAppointmentStatusVertically = false;
    scheduler.AppointmentViewInfoCustomizing += scheduler_AppointmentViewInfoCustomizing_1;
    scheduler.ActiveView.LayoutChanged();
public static void scheduler_AppointmentViewInfoCustomizing_1(object sender, AppointmentViewInfoCustomizingEventArgs e) {
    if (e.ViewInfo.Description.Contains("Time"))
        e.ViewInfo.StatusDisplayType = AppointmentStatusDisplayType.Time;
}

AppointmentViewInfoCustomizingSamples.vb

    Dim apt As Appointment = scheduler.ActiveView.GetAppointments()(0)
    apt.End = apt.End.AddDays(1)
    apt.Description = "Time"
    scheduler.ActiveViewType = SchedulerViewType.Day
    scheduler.DayView.AppointmentDisplayOptions.AllDayAppointmentsStatusDisplayType = AppointmentStatusDisplayType.Bounds
    scheduler.DayView.AppointmentDisplayOptions.ShowAllDayAppointmentStatusVertically = False
    AddHandler scheduler.AppointmentViewInfoCustomizing, AddressOf scheduler_AppointmentViewInfoCustomizing_1
    scheduler.ActiveView.LayoutChanged()
Public Shared Sub scheduler_AppointmentViewInfoCustomizing_1(ByVal sender As Object, ByVal e As AppointmentViewInfoCustomizingEventArgs)
    If e.ViewInfo.Description.Contains("Time") Then
        e.ViewInfo.StatusDisplayType = AppointmentStatusDisplayType.Time
    End If
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the StatusDisplayType property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-schedulercontrol-api-t224044/CS/SchedulerAPISample/CodeExamples/AppointmentViewInfoCustomizingSamples.cs#L48

    if (e.ViewInfo.Description.Contains("Time"))
        e.ViewInfo.StatusDisplayType = AppointmentStatusDisplayType.Time;
}

VB.NET

winforms-schedulercontrol-api-t224044/VB/SchedulerAPISample/CodeExamples/AppointmentViewInfoCustomizingSamples.vb#L41

If e.ViewInfo.Description.Contains("Time") Then
    e.ViewInfo.StatusDisplayType = AppointmentStatusDisplayType.Time
End If