SchedulerControl.CustomizeVisualViewInfo Event

Enables to customize the visual representation of the currently active view's elements for the currently selected type of grouping appointments.

Namespace: DevExpress.Xpf.Scheduler

Assembly: DevExpress.Xpf.Scheduler.v20.1.dll

Declaration

public event CustomizeVisualViewInfoEventHandler CustomizeVisualViewInfo
Public Event CustomizeVisualViewInfo As CustomizeVisualViewInfoEventHandler

Event Data

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

Property Description
VisualViewInfo Gets an object which contains information on the visual representation of visual elements displayed in the Scheduler Control, depending on the current active view and group type currently applied to appointments.

Remarks

IMPORTANT

You are viewing documentation for the legacy WPF Scheduler control. If you're starting a new project, we strongly recommend that you use a new control declared in the DevExpress.Xpf.Scheduling namespace. If you decide to upgrade an existing project in order to switch to the updated scheduler control, see the Migration Guidelines document.

Handle the CustomizeVisualViewInfo event to customize the visualization of the current active view's elements displayed in the Scheduler Control, when one of the available types of grouping is applied to appointments.

The event parameter's CustomizeVisualViewInfoEventArgs.VisualViewInfo property returns the VisualViewInfoBase class descendant, providing access to information on visual representation of the current view's elements, depending on the currently applied group type.

Examples

This example demonstrates how to handle the SchedulerControl.CustomizeVisualViewInfo event to hide day headers and time ruler headers in the Scheduler Control when the Day View is currently active and the view is grouped by resources. To do this, set the VisualDayViewResourcesBasedViewInfo.ShowDayHeaders and VisualDayViewResourcesBasedViewInfo.ShowTimeRulerHeader properties to false.

private void schedulerControl1_CustomizeVisualViewInfo(object sender, DevExpress.Xpf.Scheduler.CustomizeVisualViewInfoEventArgs e) {
    // Determine whether the currently active view is the Day View and appointments are grouped by resource.
    if (e.VisualViewInfo is VisualDayViewGroupByResource) {
        VisualDayViewGroupByResource dayViewByResource = (VisualDayViewGroupByResource)e.VisualViewInfo;
        // Hide day headers.
       dayViewByResource.ShowDayHeaders = false;
        // Hide time ruler headers.
        dayViewByResource.ShowTimeRulerHeader = false;
    }
}
See Also