Class CircleSlider

Definition

Namespace:

ElmSharp.Wearable

Assembly:

ElmSharp.Wearable.dll

Circle slider is a circular designed widget used to select a value in a range by the Rotary event.

public class CircleSlider : Widget, IAccessibleObject, IRotaryActionWidget, ICircleWidget

Inheritance

object

EvasObject

AccessibleObject

Widget

CircleSlider

Implements

IAccessibleObject

IRotaryActionWidget

ICircleWidget

Constructors

CircleSlider(EvasObject, CircleSurface)

Creates and initializes a new instance of the CircleSlider class.

Declaration

public CircleSlider(EvasObject parent, CircleSurface surface)

Parameters

Type	Name	Description
EvasObject	parent	The EvasObject to which the new CircleSlider will be attached as a child.
CircleSurface	surface	The surface for drawing the circle features for this widget.

Properties

BackgroundAngle

Sets or gets the angle in degree of the circle slider background.

Declaration

public double BackgroundAngle { get; set; }

Property Value

Type	Description
double

BackgroundAngleOffset

Sets or gets the angle offset for the circle slider background. Offset value means start position of the slider background.

Declaration

public double BackgroundAngleOffset { get; set; }

Property Value

Type	Description
double

BackgroundColor

Sets or gets the color of the circle slider background.

Declaration

public override Color BackgroundColor { get; set; }

Property Value

Type	Description
Color

Overrides

Widget.BackgroundColor

BackgroundLineWidth

Sets or gets the line width of the circle slider background.

Declaration

public int BackgroundLineWidth { get; set; }

Property Value

Type	Description
int

BackgroundRadius

Gets or sets the radius value for the circle slider background.

Declaration

public double BackgroundRadius { get; set; }

Property Value

Type	Description
double

BarAngle

Sets or gets the angle in degree of the circle slider bar.

Declaration

public double BarAngle { get; set; }

Property Value

Type	Description
double

BarAngleMaximum

Sets or gets the maximum angle of the circle slider bar.

Declaration

public double BarAngleMaximum { get; set; }

Property Value

Type	Description
double

BarAngleMinimum

Sets or gets the minimum angle of the circle slider bar.

Declaration

public double BarAngleMinimum { get; set; }

Property Value

Type	Description
double

BarAngleOffset

Sets or gets the angle offset for the slider bar. Offset value means start position of the slider bar.

Declaration

public double BarAngleOffset { get; set; }

Property Value

Type	Description
double

BarColor

Sets or gets the color of the circle slider bar.

Declaration

public Color BarColor { get; set; }

Property Value

Type	Description
Color

BarLineWidth

Sets or gets the line width of the circle slider bar.

Declaration

public int BarLineWidth { get; set; }

Property Value

Type	Description
int

BarRadius

Gets or sets the radius value for the circle slider bar.

Declaration

public double BarRadius { get; set; }

Property Value

Type	Description
double

CircleHandle

Gets the handle for the Circle widget.

Declaration

public virtual IntPtr CircleHandle { get; }

Property Value

Type	Description
System.IntPtr

CircleSurface

Gets the handle for the circle surface used in this widget.

Declaration

public virtual CircleSurface CircleSurface { get; }

Property Value

Type	Description
CircleSurface

IsEnabled

Sets or gets the state of the widget, which might be enabled or disabled.

Declaration

public override bool IsEnabled { get; set; }

Property Value

Type	Description
bool

Overrides

Widget.IsEnabled

Maximum

Sets or gets the maximum values for the circle slider.

Declaration

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 than the maximum value, it is updated to the maximum value. Actual value can be obtained with Value. By default, the minimum value is equal to 0.0, and the maximum value is equal to 1.0. Maximum must be greater than minimum, otherwise the behavior is undefined.

Minimum

Sets or gets the minimum values for the circle slider.

Declaration

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 the minimum value, it is updated to the minimum value. Actual value can be obtained with Value. By default, minimum value is equal to 0.0.

Step

Sets or gets the step by which the circle slider bar moves.

Declaration

public double Step { get; set; }

Property Value

Type	Description
double

Remarks

This value is used when the circle slider value is changed by a drag or the Rotary event. The value of the slider is increased/decreased by the step value.

Value

Gets or sets the value displayed by the circle slider.

Declaration

public double Value { get; set; }

Property Value

Type	Description
double

Remarks

The value must be between minimum and maximum.

Methods

CreateHandle(EvasObject)

Creates a widget handle.

Declaration

protected override IntPtr CreateHandle(EvasObject parent)

Parameters

Type	Name	Description
EvasObject	parent	Parent EvasObject

Returns

Type	Description
System.IntPtr	Handle IntPtr.

Overrides

EvasObject.CreateHandle(EvasObject)

OnRealized()

The callback of the Realized event.

Declaration

protected override void OnRealized()

Overrides

Widget.OnRealized()

Events

ValueChanged

Changed will be triggered when the circle slider value changes.

Declaration

public event EventHandler ValueChanged

Event Type

Type	Description
System.EventHandler

Implements

IAccessibleObject

IRotaryActionWidget

ICircleWidget

Extension Methods

RotaryEventExtensions.Activate(EvasObject)

RotaryEventExtensions.AddRotaryEventHandler(EvasObject, RotaryEventHandler)

RotaryEventExtensions.Deactivate(EvasObject)

RotaryEventExtensions.RemoveRotaryEventHandler(EvasObject, RotaryEventHandler)

RotaryEventExtensions.Activate(IRotaryActionWidget)

RotaryEventExtensions.Deactivate(IRotaryActionWidget)