New to Telerik UI for .NET MAUI? Start a free 30-day trial

MultidayViewDefinitionBase

Class

Represents abstract definition of a view that shows multiple days. This base class provides common functionality for all multi-day scheduler views, including day view, week view, and custom multi-day views. It defines time ranges, tick intervals, styling options, and special slot handling.

Definition

Namespace:Telerik.Maui.Controls

Assembly:Telerik.Maui.Controls.dll

Syntax:

public abstract class MultidayViewDefinitionBase : ViewDefinitionBase, INotifyPropertyChanged

Inheritance: objectViewDefinitionBaseMultidayViewDefinitionBase

Derived Classes: DayViewDefinitionMultidayViewDefinitionWeekViewDefinition

Implements: INotifyPropertyChanged

Inherited Members ViewDefinitionBase.TitlePropertyViewDefinitionBase.HeaderTextFormatPropertyViewDefinitionBase.TitleViewDefinitionBase.HeaderTextFormat

Constructors

MultidayViewDefinitionBase()

Initializes a new instance of the MultidayViewDefinitionBase class. Sets up default style selectors and configures the current time indicator based on visibility settings.

public MultidayViewDefinitionBase()

Fields

DayEndTimeProperty

BindableProperty

Identifies the DayEndTime property.

public static readonly BindableProperty DayEndTimeProperty

DayStartTimeProperty

BindableProperty

Identifies the DayStartTime property.

public static readonly BindableProperty DayStartTimeProperty

DayStringFormatProperty

BindableProperty

Identifies the DayStringFormat bindable property.

public static readonly BindableProperty DayStringFormatProperty

DayStyleSelectorProperty

BindableProperty

Identifies the DayStyleSelector property.

public static readonly BindableProperty DayStyleSelectorProperty

HorizontalLineStyleProperty

BindableProperty

Identifies the HorizontalLineStyle property.

public static readonly BindableProperty HorizontalLineStyleProperty

IsCurrentTimeIndicatorVisibleProperty

BindableProperty

Identifies the IsCurrentTimeIndicatorVisible property.

public static readonly BindableProperty IsCurrentTimeIndicatorVisibleProperty

LinesThicknessProperty

BindableProperty

Identifies the LinesThickness property.

public static readonly BindableProperty LinesThicknessProperty

MajorTickLengthProperty

BindableProperty

Identifies the MajorTickLength property.

public static readonly BindableProperty MajorTickLengthProperty

MajorTickLineStyleProperty

BindableProperty

Identifies the MajorTickLineStyle property.

public static readonly BindableProperty MajorTickLineStyleProperty

MaxTimeRulerExtentProperty

BindableProperty

Identifies the MaxTimeRulerExtent property.

public static readonly BindableProperty MaxTimeRulerExtentProperty

MinorTickLengthProperty

BindableProperty

Identifies the MinorTickLength property.

public static readonly BindableProperty MinorTickLengthProperty

MinorTickLineStyleProperty

BindableProperty

Identifies the MinorTickLineStyle property.

public static readonly BindableProperty MinorTickLineStyleProperty

MinTimeRulerExtentProperty

BindableProperty

Identifies the MinTimeRulerExtent property.

public static readonly BindableProperty MinTimeRulerExtentProperty

SpecialSlotsSourceProperty

BindableProperty

Identifies the SpecialSlotsSource property.

public static readonly BindableProperty SpecialSlotsSourceProperty

SpecialSlotStyleSelectorProperty

BindableProperty

Identifies the SpecialSlotStyleSelector property.

public static readonly BindableProperty SpecialSlotStyleSelectorProperty

SpecialSlotTemplateProperty

BindableProperty

Identifies the SpecialSlotTemplate property.

public static readonly BindableProperty SpecialSlotTemplateProperty

TimeRulerLabelStyleProperty

BindableProperty

Identifies the TimeRulerLabelStyle property.

public static readonly BindableProperty TimeRulerLabelStyleProperty

TimeRulerMajorTickStringFormatProperty

BindableProperty

Identifies the TimeRulerMajorTickStringFormat bindable property.

public static readonly BindableProperty TimeRulerMajorTickStringFormatProperty

TimeRulerWidthProperty

BindableProperty

Identifies the TimeRulerWidth bindable property.

public static readonly BindableProperty TimeRulerWidthProperty

VerticalLineStyleProperty

BindableProperty

Identifies the VerticalLineStyle property.

public static readonly BindableProperty VerticalLineStyleProperty

Properties

DayEndTime

TimeOnly

Gets or sets the time used to indicate the end of the day. This property defines when the visible time range ends in the scheduler view. Appointments and time slots after this time will not be displayed.

public TimeOnly DayEndTime { get; set; }

Property Value:

A TimeOnly value representing the end of the visible day. Default is TimeOnly.MaxValue (23:59:59).

DayStartTime

TimeOnly

Gets or sets the time used to indicate the start of the day. This property defines when the visible time range begins in the scheduler view. Appointments and time slots before this time will not be displayed.

public TimeOnly DayStartTime { get; set; }

Property Value:

A TimeOnly value representing the start of the visible day. Default is TimeOnly.MinValue (00:00).

DayStringFormat

string

Gets or sets the string format of the header days. This property controls how day information is displayed in the day headers, allowing customization of date presentation across different cultures and preferences.

public string DayStringFormat { get; set; }

Property Value:

A format string used to display day information. Uses standard .NET date format strings.

DayStyleSelector

IStyleSelector

Gets or sets the style selector of the days. The day style selector allows conditional styling of day headers based on day state, such as highlighting today differently from other days.

public IStyleSelector DayStyleSelector { get; set; }

Property Value:

An IStyleSelector that provides styles for day headers.

HorizontalLineStyle

Style

Gets or sets the style of the horizontal lines. Horizontal lines separate time periods and create the grid structure that helps users align appointments with specific times.

public Style HorizontalLineStyle { get; set; }

Property Value:

A Style object defining the appearance of horizontal grid lines.

IsCurrentTimeIndicatorVisible

bool

Gets or sets a value indicating whether the current time indicator is visible. When enabled, displays a line or marker showing the current time position within the scheduler view, updating automatically as time progresses.

public bool IsCurrentTimeIndicatorVisible { get; set; }

Property Value:

True to show the current time indicator, false to hide it. Default is true.

LinesThickness

double

Gets or sets the thickness of the lines. This property controls the visual weight of grid lines, affecting the overall appearance and readability of the scheduler layout.

public double LinesThickness { get; set; }

Property Value:

A double value representing line thickness in device-independent units. Default varies by platform.

MajorTickLength

TimeSpan

Gets or sets the length of the major ticks. Major ticks represent the primary time intervals displayed in the time ruler and typically show hour boundaries with visible labels.

public TimeSpan MajorTickLength { get; set; }

Property Value:

A TimeSpan representing the interval between major ticks. Default is 1 hour.

MajorTickLineStyle

Style

Gets or sets the style of the major lines. Major tick lines correspond to major time intervals (typically hours) and are usually more prominent than minor tick lines.

public Style MajorTickLineStyle { get; set; }

Property Value:

A Style object defining the appearance of major tick lines.

MaxTimeRulerExtent

double

Gets or sets the maximum size of the time ruler in pixels.

public double MaxTimeRulerExtent { get; set; }

Property Value:

The maximum size of the time ruler in pixels.

Remarks:

This property determines the maximum size of the time ruler in pixels. MaxTimeRulerExtent of 1400 pixels means that the time ruler will be rendered with no more than 1400 pixels no matter how much time it represents. If there is less than 1400 pixels available, it will be squeezed as much as the value of the MinTimeRulerExtent property allows to.

MinorTickLength

TimeSpan

Gets or sets the length of the minor ticks. Minor ticks represent secondary time intervals displayed between major ticks, providing finer granularity for time positioning without labels.

public TimeSpan MinorTickLength { get; set; }

Property Value:

A TimeSpan representing the interval between minor ticks. Default is 30 minutes.

MinorTickLineStyle

Style

Gets or sets the style of the minor lines. Minor tick lines appear between major ticks and provide finer time granularity. They are typically styled to be less prominent than major tick lines.

public Style MinorTickLineStyle { get; set; }

Property Value:

A Style object defining the appearance of minor tick lines.

MinTimeRulerExtent

double

Gets or sets the minimum size of the time ruler in pixels.

public double MinTimeRulerExtent { get; set; }

Property Value:

The minimum size of the time ruler in pixels.

Remarks:

This property determines the minimum size of the time ruler in pixels. MinTimeRulerExtent of 1400 pixels means that the time ruler will be rendered with at least 1400 pixels no matter how much time it represents. If there is more than 1400 pixels available, it will be stretched as much as the value of the MaxTimeRulerExtent property allows to.

SpecialSlotsSource

IEnumerable<Slot>

Gets or sets the special slots source. Special slots are used to highlight specific time periods with different styling, such as lunch breaks, holidays, maintenance windows, or unavailable periods.

public IEnumerable<Slot> SpecialSlotsSource { get; set; }

Property Value:

An enumerable collection of Slot objects defining special time periods.

SpecialSlotStyleSelector

IStyleSelector

Gets or sets the style selector of the special slots. Special slot style selector enables conditional styling of special time periods based on slot properties, such as read-only state or custom slot types.

public IStyleSelector SpecialSlotStyleSelector { get; set; }

Property Value:

An IStyleSelector that provides styles for special slots.

SpecialSlotTemplate

DataTemplate

Gets or sets the template of the special slots. Special slot template allows complete customization of special slot appearance beyond simple styling, enabling complex content and layouts.

public DataTemplate SpecialSlotTemplate { get; set; }

Property Value:

A DataTemplate that defines the visual structure for special slots.

TimeRulerLabelStyle

Style

Gets or sets the style of the time ruler labels. Time ruler labels display time information alongside major ticks, helping users identify specific times for appointment scheduling.

public Style TimeRulerLabelStyle { get; set; }

Property Value:

A Style object defining the appearance of time labels in the time ruler.

TimeRulerMajorTickStringFormat

string

Gets or sets the string format of the major ticks. This property controls how time information is displayed in the time ruler for major tick marks, allowing customization of time presentation.

public string TimeRulerMajorTickStringFormat { get; set; }

Property Value:

A format string used to display time information. Uses standard .NET time format strings.

TimeRulerWidth

double

Gets or sets the width of the TimeRuler. This property controls the horizontal space allocated to the time ruler, affecting how much room is available for time labels and the overall layout balance.

public double TimeRulerWidth { get; set; }

Property Value:

A double value representing the width in device-independent units. Must be non-negative.

VerticalLineStyle

Style

Gets or sets the style of the vertical lines. Vertical lines separate different days in multi-day views, providing visual boundaries between day columns.

public Style VerticalLineStyle { get; set; }

Property Value:

A Style object defining the appearance of vertical separator lines.

Methods

CreateDefaultTitle()

string

Creates the default title for the view definition.

protected override string CreateDefaultTitle()

Returns:

string

Overrides: ViewDefinitionBase.CreateDefaultTitle()