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.
C#Copypublic class Slider : Layout, IAccessibleObject
- Inheritance
- Implements
Constructors
Declaration
C#Copypublic Slider(EvasObject parent)
Parameters
| Type | Name | Description |
|---|---|---|
| EvasObject | parent | The EvasObject to which the new slider will be attached as a child. |
Properties
Declaration
C#Copypublic 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.
Declaration
C#Copypublic SliderIndicatorVisibleMode IndicatorVisibleMode { get; set; }
Property Value
| Type | Description |
|---|---|
| SliderIndicatorVisibleMode |
Declaration
C#Copypublic bool IsHorizontal { get; set; }
Property Value
| Type | Description |
|---|---|
| bool |
Remarks
The orientation may be vertical or horizontal. By default, it's displayed horizontally.
Declaration
C#Copypublic bool IsIndicatorFocusable { get; set; }
Property Value
| Type | Description |
|---|---|
| bool |
IsIndicatorVisible
Sets or gets whether to enlarge the slider indicator (augmented knob).
Declaration
C#Copypublic 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.
Declaration
C#Copypublic 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.
Declaration
C#Copypublic 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.
Declaration
C#Copypublic 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.
Declaration
C#Copypublic 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.
Declaration
C#Copypublic 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.
Declaration
C#Copypublic 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
Declaration
C#Copyprotected override IntPtr CreateHandle(EvasObject parent)
Parameters
| Type | Name | Description |
|---|---|---|
| EvasObject | parent | Parent EvasObject. |
Returns
| Type | Description |
|---|---|
| System.IntPtr | Handle IntPtr. |
Overrides
Events
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
C#Copypublic event EventHandler DelayedValueChanged
Event Type
| Type | Description |
|---|---|
| System.EventHandler |
DragStarted
DragStarted will be triggered when dragging the Slider indicator around has started.
Declaration
C#Copypublic event EventHandler DragStarted
Event Type
| Type | Description |
|---|---|
| System.EventHandler |
DragStopped
DragStopped will be triggered when dragging the Slider indicator around has stopped.
Declaration
C#Copypublic event EventHandler DragStopped
Event Type
| Type | Description |
|---|---|
| System.EventHandler |
ValueChanged
ValueChanged will be triggered when the Slider value is changed by the user.
Declaration
C#Copypublic event EventHandler ValueChanged
Event Type
| Type | Description |
|---|---|
| System.EventHandler |