public class SfDateTimeRangeSlider : RangeSliderBase<DateTime>, IDrawableLayout, IDrawable, IAbsoluteLayout, ILayout, IView, IElement, ITransform, IContainer, IList<IView>, ICollection<IView>, IEnumerable<IView>, IEnumerable, ISafeAreaView, IPadding, ICrossPlatformLayout, IVisualTreeElement, ISemanticsProvider, ITouchListener, ITapGestureListener, IPanGestureListener, IGestureListener, IInteractionState, IRangeView<DateTime>, IDateTimeElement, IOrientationElement, IParentThemeElement, IThemeElement

Constructors

SfDateTimeRangeSlider()

Initializes a new instance of the SfDateTimeRangeSlider class.

Declaration

public SfDateTimeRangeSlider()

Fields

DateFormatProperty

The backing store for the DateFormat field.

Declaration

public static readonly BindableProperty DateFormatProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	Microsoft.Maui.Controls.BindableProperty.

IntervalTypeProperty

The backing store for the IntervalType field.

Declaration

public static readonly BindableProperty IntervalTypeProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	Microsoft.Maui.Controls.BindableProperty.

OrientationProperty

The backing store for the Orientation field.

Declaration

public static readonly BindableProperty OrientationProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	Microsoft.Maui.Controls.BindableProperty.

StepDurationProperty

The backing store for the StepDuration field.

Declaration

public static readonly BindableProperty StepDurationProperty

Field Value

Type	Description
Microsoft.Maui.Controls.BindableProperty	Microsoft.Maui.Controls.BindableProperty.

Properties

DateFormat

Gets or sets the value to format the date.

Declaration

public string DateFormat { get; set; }

Property Value

Type	Description
System.String	Defaults to `string.Empty`.

Examples

Snippet for SfDateTimeRangeSlider #XAML

<sliders:SfDateTimeRangeSlider Minimum = "2010-1-1"
                               Maximum = "2011-1-1"
                               RangeStart = "2010-4-1"
                               RangeEnd = "2010-9-1"
                               ShowLabels = "True"
                               DateFormat = "M yyyy" />

SfDateTimeRangeSlider rangeSlider = new SfDateTimeRangeSlider()
{
    Minimum = new DateTime(2010, 1, 1),
    Maximum = new DateTime(2011, 1, 1),
    RangeStart = new DateTime(2010, 4, 1),
    RangeEnd = new DateTime(2010, 9, 1),
    ShowLabels = true,
    DateFormat = "M yyyy"
};

IntervalType

Gets or sets the type of the date interval.

Declaration

public SliderDateIntervalType IntervalType { get; set; }

Property Value

Type	Description
SliderDateIntervalType	Defaults to `Auto`.

Examples

Snippet for SfDateTimeRangeSlider

XAML
C#

<sliders:SfDateTimeRangeSlider Minimum = "2010-1-1" 
                               Maximum = "2011-1-1" 
                               Value = "2010-5-1" 
                               IntervalType="Months"/>

SfDateTimeRangeSlider rangeSlider = new SfDateTimeRangeSlider()
{
    Minimum = new DateTime(2010, 1, 1),
    Maximum = new DateTime(2011, 1, 1),
    Value = new DateTime(2010, 5, 1),
    IntervalType = SliderDateIntervalType.Months
};

Orientation

Gets or sets the orientation of the DateTime Range Slider.

If you set this property to Horizontal, the slider will be render from left to right. If you set this property to Vertical, the slider will be render from bottom to top.

Declaration

public SliderOrientation Orientation { get; set; }

Property Value

Type	Description
SliderOrientation	Defaults to `Horizontal`.

<sliders:SfDateTimeRangeSlider Orientation = "Vertical" />

SfDateTimeRangeSlider rangeSlider = new SfDateTimeRangeSlider()
{
    Orientation = SliderOrientation.Vertical
};

StepDuration

Gets or set the value indication whether to select the discrete date value.

For example, if Minimum is System.DateTime(2015, 01, 01) and Maximum is System.DateTime(2020, 01, 01) and StepDuration is SliderStepDuration(Years: 1, Months: 6), the slider will move the thumb at System.DateTime(2015, 01, 01), System.DateTime(2016, 07, 01), System.DateTime(2018, 01, 01),and System.DateTime(2019, 07, 01).

Declaration

public SliderStepDuration StepDuration { get; set; }

Property Value

Type	Description
SliderStepDuration	Defaults to `default(SliderStepDuration)`.

Remarks

StepDuration does not work with BetweenThumbs.

Examples

Snippet for SfDateTimeRangeSlider

XAML
C#

<sliders:SfDateTimeRangeSlider Minimum="2010-01-01"
                               Maximum="2015-01-01"
                               RangeStart="2012-01-01"
                               RangeEnd="2016-01-01"
                               StepDuration="5">
</sliders:SfDateTimeRangeSlider>

SfDateTimeRangeSlider dateTimeRangeSlider = new SfDateTimeRangeSlider()
{ 
     Minimum = new DateTime(2010, 01, 01),
     Maximum = new DateTime(2025, 01, 01),
     RangeStart = new DateTime(2015, 01, 01),
     RangeEnd = new DateTime(2020, 01, 01),
     StepDuration = new SliderStepDuration(5)
};

Events

ValueChanged

Represents the ValueChanged event, which occurs when the user is done selecting a new value for the DateTime Range Slider.

Declaration

public event EventHandler<DateTimeRangeSliderValueChangedEventArgs> ValueChanged

Event Type

Type
System.EventHandler<DateTimeRangeSliderValueChangedEventArgs>

Examples

XAML
C#

<sliders:SfDateTimeRangeSlider ValueChanged="OnValueChanged" />

SfDateTimeRangeSlider rangeSlider = new SfDateTimeRangeSlider()
{
    ValueChanged += OnValueChanged
}

private void OnValueChanged(object sender, DateTimeRangeSliderValueChangedEventArgs e)
{
}

ValueChanging

Represents the ValueChanging event, which occurs when the user is selecting a new value for the DateTime Range Slider by dragging any one of the thumb.

Declaration

public event EventHandler<DateTimeRangeSliderValueChangingEventArgs> ValueChanging

Event Type

Type
System.EventHandler<DateTimeRangeSliderValueChangingEventArgs>

Examples

XAML
C#

<sliders:SfDateTimeRangeSlider ValueChanging="OnValueChanging" />

SfDateTimeRangeSlider rangeSlider = new SfDateTimeRangeSlider()
{
    ValueChanging += OnValueChanging
}

private void OnValueChanging(object sender, DateTimeRangeSliderValueChangingEventArgs e)
{
}

Explicit Interface Implementations

IDateTimeElement.OnDateFormatChanged(String, String)

Declaration

void IDateTimeElement.OnDateFormatChanged(string oldValue, string newValue)

Parameters

Type	Name	Description
System.String	oldValue
System.String	newValue

IDateTimeElement.OnIntervalTypeChanged(SliderDateIntervalType, SliderDateIntervalType)

Declaration

void IDateTimeElement.OnIntervalTypeChanged(SliderDateIntervalType oldValue, SliderDateIntervalType newValue)

Parameters

Type	Name	Description
SliderDateIntervalType	oldValue
SliderDateIntervalType	newValue

IDateTimeElement.OnStepChanged()

Declaration

void IDateTimeElement.OnStepChanged()

IOrientationElement.OnOrientationChanged(SliderOrientation)

Declaration

void IOrientationElement.OnOrientationChanged(SliderOrientation newValue)

Parameters

Type	Name	Description
SliderOrientation	newValue

Implements

IDrawableLayout

Microsoft.Maui.Graphics.IDrawable

Microsoft.Maui.IAbsoluteLayout

Microsoft.Maui.ILayout

Microsoft.Maui.IView

Microsoft.Maui.IElement

Microsoft.Maui.ITransform

Microsoft.Maui.IContainer

System.Collections.Generic.IList<>

System.Collections.Generic.ICollection<>

System.Collections.Generic.IEnumerable<>

System.Collections.IEnumerable

Microsoft.Maui.ISafeAreaView

Microsoft.Maui.IPadding

Microsoft.Maui.ICrossPlatformLayout

Microsoft.Maui.IVisualTreeElement

IDateTimeElement

IOrientationElement