VisualDayViewResourcesBasedViewInfo.ShowTimeRulerHeader Property

Specifies whether to display time ruler in the Day or Work-Week view when appointments are grouped by resources or no grouping is applied.

Namespace: DevExpress.Xpf.Scheduler.Drawing

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

NuGet Package: DevExpress.Wpf.Scheduler

Declaration

C#

public bool ShowTimeRulerHeader { get; set; }

VB.NET

Public Property ShowTimeRulerHeader As Boolean

Property Value

Type	Description
Boolean	true to display time ruler headers; otherwise, false.

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.

The ShowTimeRulerHeader property can be used when the DayView or WorkWeekView is the current active view, and appointments are grouped by resources or no grouping is applied in the SchedulerControl.

To access the VisualDayViewResourcesBasedViewInfo class descendant for obtaining the value of the ShowTimeRulerHeader property, you can use the SchedulerViewBase.VisualViewInfo property of the object returned by the SchedulerControl.ActiveView property. To set the ShowTimeRulerHeader property value, handle the SchedulerControl.CustomizeVisualViewInfo event. Its parameter’s CustomizeVisualViewInfoEventArgs.VisualViewInfo property returns the VisualDayViewResourcesBasedViewInfo class descendant.

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.

View Example

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 ShowTimeRulerHeader 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.

XAML

how-to-customize-dayview-with-a-custom-template-and-by-handling-a-specific-event-t411679/CS/CustomDayViewGroupByNoneStyle.xaml#L44

<Grid Visibility="{Binding ShowTimeRulers, RelativeSource={RelativeSource Mode=TemplatedParent}, Converter={StaticResource boolToVisibilityConverter}}">
    <dx:XPFContentControl Visibility="{Binding ShowTimeRulerHeader, RelativeSource={RelativeSource Mode=TemplatedParent}, Converter={StaticResource boolToVisibilityConverter}}" Style="{DynamicResource {dxscht:DayViewThemeKey ResourceKey=TimeRulerHeadersContainerStyle}}">

C#

how-to-customize-dayview-with-a-custom-template-and-by-handling-a-specific-event-t411679/CS/MainWindow.xaml.cs#L31

    // Hide time ruler headers.
    dayViewByResource.ShowTimeRulerHeader = false;
}

VB.NET

how-to-customize-dayview-with-a-custom-template-and-by-handling-a-specific-event-t411679/VB/MainWindow.xaml.vb#L33

    ' Hide time ruler headers.
    dayViewByResource.ShowTimeRulerHeader = False
End If