Class Slider

Definition

Namespace:: ElmSharp

Assembly:: ElmSharp.dll

The Slider is a widget that adds a draggable slider widget for selecting the value of something within a range.

[Obsolete("This has been deprecated in API12")]
public class Slider : Layout, IAccessibleObject

Inheritance: object

EvasObject

AccessibleObject

Widget

Container

Layout

Slider

Implements: IAccessibleObject

Constructors

View Source

Slider(EvasObject)

Creates and initializes a new instance of the Slider class.

Declaration

[Obsolete("This has been deprecated in API12")]
public Slider(EvasObject parent)

Parameters

Type	Name	Description
EvasObject	parent	The EvasObject to which the new slider will be attached as a child.

Properties

View Source

IndicatorFormat

Sets or gets the format string for the indicator label.

Declaration

[Obsolete("This has been deprecated in API12")]
public string IndicatorFormat { get; set; }

Property Value

Type	Description
string

Remarks

The slider may display its value somewhere other than the unit label, for example, above the slider knob that is dragged around. This function sets the format string used for this. If null, the indicator label won't be visible. If not, it sets the format string for the label text. For the label text floating point value is provided, so the label text can display up to 1 floating point value. Note that this is optional. Use a format string such as "%1.2f meters" for example, and it displays values like: "3.14 meters" for a value equal to 3.14159. By default, the indicator label is disabled.

View Source

IndicatorVisibleMode

Sets or gets the visible mode of the slider indicator.

Declaration

[Obsolete("This has been deprecated in API12")]
public SliderIndicatorVisibleMode IndicatorVisibleMode { get; set; }

Property Value

Type	Description
SliderIndicatorVisibleMode

View Source

IsHorizontal

Sets or gets the orientation of a given slider widget.

Declaration

[Obsolete("This has been deprecated in API12")]
public bool IsHorizontal { get; set; }

Property Value

Type	Description
bool

Remarks

The orientation may be vertical or horizontal. By default, it's displayed horizontally.

View Source

IsIndicatorFocusable

Sets or gets whether to show the indicator of a slider on focus.

Declaration

[Obsolete("This has been deprecated in API12")]
public bool IsIndicatorFocusable { get; set; }

Property Value

Type	Description
bool

View Source

IsIndicatorVisible

Sets or gets whether to enlarge the slider indicator (augmented knob).

Declaration

[Obsolete("This has been deprecated in API12")]
public bool IsIndicatorVisible { get; set; }

Property Value

Type	Description
bool

Remarks

By default, the indicator is bigger when dragged by the user. It won't display the values set with IndicatorFormat if you disable the indicator.

View Source

IsInverted

Gets or sets whether a given slider widget's displaying values are inverted.

Declaration

[Obsolete("This has been deprecated in API12")]
public bool IsInverted { get; set; }

Property Value

Type	Description
bool

Remarks

A slider may be inverted, in which case it gets its values inverted, with high values being on the left or top, and low values on the right or bottom, as opposed to normally have the low values on the former and high values on the latter, respectively, for the horizontal and vertical modes.

View Source

Maximum

Sets or gets the maximum values for the slider.

Declaration

[Obsolete("This has been deprecated in API12")]
public double Maximum { get; set; }

Property Value

Type	Description
double

Remarks

This defines the allowed maximum values to be selected by the user. If the actual value is bigger then max, it is updated to max. Actual value can be obtained with value. By default, minimum is equal to 0.0 and maximum is equal to 1.0. Maximum must be greater than minimum, otherwise the behavior is undefined.

View Source

Minimum

Sets or gets the minimum values for the slider.

Declaration

[Obsolete("This has been deprecated in API12")]
public double Minimum { get; set; }

Property Value

Type	Description
double

Remarks

This defines the allowed minimum values to be selected by the user. If the actual value is less than min, it is updated to min. Actual value can be obtained with value. By default, the minimum is equal to 0.0.

View Source

SpanSize

Sets or gets the (exact) length of the bar region of a given Slider widget.

Declaration

[Obsolete("This has been deprecated in API12")]
public int SpanSize { get; set; }

Property Value

Type	Description
int

Remarks

This sets the minimum width (when in the horizontal mode) or height (when in the vertical mode) of the actual bar area of the slider object. This in turn affects the object's minimum size. Use this when you're not setting other size hints expanding on the given direction (like weight and alignment hints), and you would like it to have a specific size.

View Source

Step

Sets or gets the step by which the slider indicator moves.

Declaration

[Obsolete("This has been deprecated in API12")]
public double Step { get; set; }

Property Value

Type	Description
double

Remarks

This value is used when the draggable object is moved automatically i.e., in case of a key event when up/down/left/right key is pressed or in case accessibility is set and the flick event is used to increase or decrease the slider values. By default, the step value is equal to 0.05.

View Source

Value

Gets or sets the value displayed by the slider.

Declaration

[Obsolete("This has been deprecated in API12")]
public double Value { get; set; }

Property Value

Type	Description
double

Remarks

Value will be presented on the unit label following format specified with UnitFormat and on indicator with IndicatorFormat. The value must be between minimum and maximum values.

Methods

View Source

CreateHandle(EvasObject)

Creates a widget handle.

Declaration

[Obsolete("This has been deprecated in API12")]
protected override IntPtr CreateHandle(EvasObject parent)

Parameters

Type	Name	Description
EvasObject	parent	Parent EvasObject.

Returns

Type	Description
System.IntPtr	Handle IntPtr.

Overrides

Layout.CreateHandle(EvasObject)

Events

View Source

DelayedValueChanged

DelayedValueChanged will be triggered when a short time after the value is changed by the user. This will be called only when the user stops dragging for a very short period or when they release their finger/mouse, so it avoids possibly expensive reactions to the value change.

Declaration

[Obsolete("This has been deprecated in API12")]
public event EventHandler DelayedValueChanged

Event Type

Type	Description
System.EventHandler

View Source

DragStarted

DragStarted will be triggered when dragging the Slider indicator around has started.

Declaration

[Obsolete("This has been deprecated in API12")]
public event EventHandler DragStarted

Event Type

Type	Description
System.EventHandler

View Source

DragStopped

DragStopped will be triggered when dragging the Slider indicator around has stopped.

Declaration

[Obsolete("This has been deprecated in API12")]
public event EventHandler DragStopped

Event Type

Type	Description
System.EventHandler

View Source

ValueChanged

ValueChanged will be triggered when the Slider value is changed by the user.

Declaration

[Obsolete("This has been deprecated in API12")]
public event EventHandler ValueChanged

Event Type

Type	Description
System.EventHandler

Implements

IAccessibleObject

Extension Methods

RotaryEventExtensions.Activate(EvasObject)

RotaryEventExtensions.AddRotaryEventHandler(EvasObject, RotaryEventHandler)

RotaryEventExtensions.Deactivate(EvasObject)

RotaryEventExtensions.RemoveRotaryEventHandler(EvasObject, RotaryEventHandler)