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.v19.2.dll

Declaration

C#

public event CustomizeVisualViewInfoEventHandler CustomizeVisualViewInfo

VB.NET

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.

Example

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.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-customize-dayview-with-a-custom-template-and-by-handling-a-specific-event-t411679.

MainWindow.xaml.cs

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;
    }
}

MainWindow.xaml.vb

Private Sub schedulerControl1_CustomizeVisualViewInfo(ByVal sender As Object, ByVal e As DevExpress.Xpf.Scheduler.CustomizeVisualViewInfoEventArgs)
    ' Determine whether the currently active view is the Day View and appointments are grouped by resource.
    If TypeOf e.VisualViewInfo Is VisualDayViewGroupByResource Then
        Dim dayViewByResource As VisualDayViewGroupByResource = CType(e.VisualViewInfo, VisualDayViewGroupByResource)
        ' Hide day headers.
       dayViewByResource.ShowDayHeaders = False
        ' Hide time ruler headers.
        dayViewByResource.ShowTimeRulerHeader = False
    End If
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the CustomizeVisualViewInfo 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-dayview-with-a-custom-template-and-by-handling-a-specific-event-t411679/CS/MainWindow.xaml#L35

<dxsch:SchedulerControl Name="schedulerControl1" GroupType="Resource" Grid.Row="1" CustomizeVisualViewInfo="schedulerControl1_CustomizeVisualViewInfo">
    <dxsch:SchedulerControl.Storage>