SchedulerControl.AppointmentViewInfoCustomizing Event

Use this event to customize the appointment’s appearance by modifying the style elements when it is painted.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v19.2.dll

Declaration

C#

public event AppointmentViewInfoCustomizingEventHandler AppointmentViewInfoCustomizing

VB.NET

Public Event AppointmentViewInfoCustomizing As AppointmentViewInfoCustomizingEventHandler

Event Data

The AppointmentViewInfoCustomizing event's data class is AppointmentViewInfoCustomizingEventArgs. The following properties provide information specific to this event:

Property	Description
ViewInfo	Provides access to the object which contains the information used to render the appointment.

Remarks

To implement conditional styling based on the appointment data, handle the AppointmentViewInfoCustomizing event use the appointment’s data as a condition to modify appearance properties. The following code snippet makes the same text bold in every appointment’s subject.

C#

Font myFont = new Font("Segoe UI",8.25F, FontStyle.Bold);
//. . .
private void schedulerControl1_AppointmentViewInfoCustomizing(object sender, 
    DevExpress.XtraScheduler.AppointmentViewInfoCustomizingEventArgs e)
{
    if (e.ViewInfo.Appointment.Subject.Contains("vacation"))
        e.ViewInfo.Appearance.Font = myFont;
        //or
        //e.ViewInfo.Appearance.FontStyleDelta = Bold;
}

VB.NET

Dim myFont As New Font("Segoe UI",8.25F, FontStyle.Bold)
'. . .
Private Sub schedulerControl1_AppointmentViewInfoCustomizing(ByVal sender As Object, ByVal e As DevExpress.XtraScheduler.AppointmentViewInfoCustomizingEventArgs)
    If e.ViewInfo.Appointment.Subject.Contains("vacation") Then
        e.ViewInfo.Appearance.Font = myFont
    End If
        'or
        'e.ViewInfo.Appearance.FontStyleDelta = Bold;
End Sub

Note

This event enables you to change how the appointment is visualized. Do not modify appointment properties, and do not add or remove appointments within this event handler. An attempt to do so may result in an unhandled exception.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AppointmentViewInfoCustomizing event.

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#

how-to-customize-the-tooltips-shown-for-appointments-e155/CS/AppointmentToolTips/Form1.cs#L24

this.schedulerControl1.AppointmentViewInfoCustomizing += SchedulerControl1_AppointmentViewInfoCustomizing;

how-to-use-label-colors-to-render-appointments-background-in-the-agenda-view-t376445/CS/WindowsFormsApplication1/AgendaViewHelper.cs#L19

    scheduler.CustomDrawAppointment += scheduler_CustomDrawAppointment;
    scheduler.AppointmentViewInfoCustomizing += scheduler_AppointmentViewInfoCustomizing;
}

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

#region #AppointmentAppearance
scheduler.AppointmentViewInfoCustomizing += scheduler_AppointmentViewInfoCustomizing;
scheduler.ActiveView.LayoutChanged();

custom-form-custom-fields-and-custom-actions-on-reminder-alert-e382/CS/ReminderCustomActions/Form1.cs#L18

// Subscribe to hide reminder icons for occurrences in the past.
schedulerControl1.AppointmentViewInfoCustomizing += SchedulerControl1_AppointmentViewInfoCustomizing;
// Subscribe to update appointment info displayed in the text box on the main form.

VB.NET

how-to-customize-the-tooltips-shown-for-appointments-e155/VB/AppointmentToolTips/Form1.vb#L26

AddHandler Me.schedulerControl1.AppointmentViewInfoCustomizing, AddressOf SchedulerControl1_AppointmentViewInfoCustomizing

how-to-use-label-colors-to-render-appointments-background-in-the-agenda-view-t376445/VB/WindowsFormsApplication1/AgendaViewHelper.vb#L21

    AddHandler scheduler.CustomDrawAppointment, AddressOf scheduler_CustomDrawAppointment
    AddHandler scheduler.AppointmentViewInfoCustomizing, AddressOf scheduler_AppointmentViewInfoCustomizing
Else

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

'            #Region "#AppointmentAppearance"
AddHandler scheduler.AppointmentViewInfoCustomizing, AddressOf scheduler_AppointmentViewInfoCustomizing
scheduler.ActiveView.LayoutChanged()