Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

DayViewBase.TimeRulerCellAppearance Property

Gets or sets appearance settings of time ruler cells. This is a bindable property.

Namespace: DevExpress.Maui.Scheduler

Assembly: DevExpress.Maui.Scheduler.dll

NuGet Package: DevExpress.Maui.Scheduler

#Declaration

C#
public TimeRulerCellAppearance TimeRulerCellAppearance { get; set; }

#Property Value

Type Description
TimeRulerCellAppearance

The object that stores the appearance settings of the time ruler cells.

#Remarks

Refer to the following topic to see the available appearance properties: TimeRulerCellAppearance members.

The style configures the following cell types:

Time Ruler Cell Types

  1. TimeScaleInterval defines scale intervals into which the time ruler splits its time interval (the whole day or WorkTime only). Slots divide intervals into cells (2, 3). The TimeScaleSlotCount property specifies the number of slots within a scale interval.
  2. Interval Time Ruler Cell - a cell that corresponds to the first slot in a scale interval.
  3. Slot Time Ruler Cell - all other cells.

The View provides the following options that configure the cell’s appearance:

Time Ruler Cell Style

#Example

This example uses the time ruler cell style and its customizer to modify the cell’s appearance.

<dxs:WorkWeekView.TimeRulerCellAppearance>
    <dxs:TimeRulerCellAppearance 
        TickThickness="2"
        IntervalTickLength="10"
        SlotTickLength="5"
        IntervalTickColor="#a0a0a0"
        SlotTickColor="#d0d0d0"
        BackgroundColor="#f0f0f0"
        ContentPadding="8"
        SlotLabelFormat="{}{0:hh:mm}"
        IntervalLabelFormat="{}{0:hh:mm}"
        IntervalLabelTextColor="Black"
        SlotLabelTextColor="Gray">
        <dxs:TimeRulerCellAppearance.Customizer>
            <views:TimeRulerCellCustomizer/>
        </dxs:TimeRulerCellAppearance.Customizer>
    </dxs:TimeRulerCellAppearance>
</dxs:WorkWeekView.TimeRulerCellAppearance>
class TimeRulerCellCustomizer : ITimeRulerCellCustomizer {
    public void Customize(TimeRulerCellViewModel timeRulerCell) {
        if (timeRulerCell.IsTimeDesignatorBoundary) {
            timeRulerCell.TextFormat = "{0:hh:mm tt}";
            timeRulerCell.BackgroundColor = Colors.Orange;
        } 
    }
}

Scheduler - Time Ruler Appearance

Symbol

Description

DayViewBase.TimeRulerCellAppearance

Gets or sets appearance settings of time ruler cells. This is a bindable property.

TimeRulerCellAppearance

The storage for the appearance settings of the Day-based View’s time ruler cell.

TimeRulerCellAppearance.Customizer

Gets or sets an object that manages an individual cell’s appearance settings. This is a bindable property.

ITimeRulerCellCustomizer

If implemented by a class, modifies appearance settings of individual time ruler cell.

ITimeRulerCellCustomizer.Customize(TimeRulerCellViewModel)

Modifies appearance settings of an individual time ruler cell.

TimeRulerCellViewModel

The storage for appearance settings values of an individual time ruler cell.

See Also