public class SfDateTimeSlider : SliderBase<DateTime>, IDrawableLayout, IDrawable, IAbsoluteLayout, ILayout, IView, IElement, ITransform, IContainer, IList<IView>, ICollection<IView>, IEnumerable<IView>, IEnumerable, ISafeAreaView, IPadding, IVisualTreeElement, ITouchListener, ITapGestureListener, IPanGestureListener, IGestureListener, IOrientationElement, IRangeView<DateTime>, IDateTimeElement

Constructors

SfDateTimeSlider()

Initializes a new instance of the SfDateTimeSlider class.

Declaration

public SfDateTimeSlider()

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.

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

#XAML

<sliders:SfDateTimeSlider Minimum = "2010-1-1"
                          Maximum = "2011-1-1"
                          Value = "2010-4-1"
                          ShowLabels = "True"
                          DateFormat = "M yyyy" />

SfDateTimeSlider slider = new SfDateTimeSlider()
{
    Minimum = new DateTime(2010, 1, 1),
    Maximum = new DateTime(2011, 1, 1),
    Value = new DateTime(2010, 4, 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`.

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

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

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

XAML

<sliders:SfDateTimeSlider Minimum="2010-01-01"
                          Maximum="2015-01-01"
                          Value="2012-01-01"
                          StepDuration="5">
</sliders:SfDateTimeSlider>

Events

ValueChanged

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

Declaration

public event EventHandler<DateTimeSliderValueChangedEventArgs> ValueChanged

Event Type

Type	Description
System.EventHandler<DateTimeSliderValueChangedEventArgs>

Examples

XAML
C#

<sliders:SfDateTimeSlider ValueChanged="OnValueChanged" />

SfDateTimeSlider slider = new SfDateTimeSlider()
{
    ValueChanged += OnValueChanged
}

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

ValueChanging

Represents the ValueChanging event, which occurs when the user is selecting a new value for the DateTime slider by dragging the thumb.

Declaration

public event EventHandler<DateTimeSliderValueChangingEventArgs> ValueChanging

Event Type

Type	Description
System.EventHandler<DateTimeSliderValueChangingEventArgs>

Examples

XAML
C#

<sliders:SfDateTimeSlider ValueChanging="OnValueChanging" />

SfDateTimeSlider slider = new SfDateTimeSlider()
{
    ValueChanging += OnValueChanging
}

private void OnValueChanging(object sender, DateTimeSliderValueChangingEventArgs 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()

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

IOrientationElement

IDateTimeElement