Reference for the Mosaic class Flat::RotaryKnob

Flat::RotaryKnob
BackColor
CurrentValue
Divisor
DotPosition
ItemColor
ItemColorActive
MaxText
MaxValue
MinText
MinValue
OnApply
OnChange
Outlet
ShowCurrent
TextColor
startValue
formatValueString()
onEndSlot
onRotateSlot
onStartSlot
outletSlot
Core::Group
AlphaBlended
Buffered
Embedded
Enabled
Focus
Opacity
Visible
Add()
AddBehind()
BroadcastEvent()
BroadcastEventAtPosition()
CountViews()
DispatchEvent()
FindNextView()
FindPrevView()
FindSiblingView()
FindViewAtPosition()
FindViewInDirection()
FindViewWithinArea()
GetContentArea()
GetIndexOfView()
GetViewAtIndex()
GlobalPosition()
HasViewState()
Init()
InvalidateArea()
InvalidateViewState()
LocalPosition()
ObtainFocus()
Remove()
Restack()
RestackBack()
RestackBehind()
RestackTop()
UpdateLayout()
UpdateViewState()
Core::RectView
Bounds
Core::View
Layout
Owner
ArrangeView()
ChangeViewState()
CursorHitTest()
Draw()
GetExtent()
GetRoot()
HandleEvent()
MoveView()

Rotary know widget with a flat design. The widget allows the user to change a value by rotating a thumb arround the widgets center.

property color BackColor = Flat::ColorOfBody;

The property 'BackColor' defines the background color of the widget. The property is used to assign a color independent from the current theme color.

property int32 CurrentValue = 50;

The property 'CurrentValue' stores the momentary value of the widget. The value is limited automatically to the range from MinValue to MaxValue.

property int32 Divisor = 1;

The property 'Divisor' stores the ratio for the display value.

property int32 DotPosition = 0;

The property 'DotPosition' stores the index of the digit where the dot is shown. In case that 'DotPosition' is zero, the dot disappears.

property color ItemColor = Flat::ColorOfTouch;

The property 'ItemColor' defines the color of the widgets touchable member (knob). The property is used to assign a color independent from the current theme color.

property color ItemColorActive = Flat::ColorOfTheme;

The property 'ItemColorActive' defines the color of the widgets touchable member (knob) while it is touched by the user. The property is used to assign a color independent from the current theme color.

property Flat::MinMaxText MaxText = null;

The property 'MaxText' can refer to a Flat::MinMaxText item, which receives the current MaxValue of the widget as formatted text.

property int32 MaxValue = 100;

The property 'MaxValue' defines the upper boundary of the widgets value range.

property Flat::MinMaxText MinText = null;

The property 'MinText' can refer to a Flat::MinMaxText item, which receives the current MinValue of the widget as formatted text.

property int32 MinValue = 0;

The property 'MinValue' defines the lower boundary of the widgets value range.

property slot OnApply = null;

The property 'OnApply' can refer to a slot method, which will receive a signal when the user has released the slider. Thereupon the method's logic will be executed.

property slot OnChange = null;

The property 'OnChange' can refer to a slot method, which will receive a signal each time the user has changed the value of the slider. Thereupon the method's logic will be executed.

property ^int32 Outlet = null;

The property 'Outlet' provides an interface for the Model-View-Controller (MVC). In the MVC, the widgets (views, controllers) and the application logic (model) are always kept apart. An automatism behind this model ensures, that widgets are notified automatically as soon as the affected model has changed its state. On the other hand, user interactions on a widget cause the affected model to execute the application logic. Usually, a model is a simple Chora object containing several properties and the implementation of onget/onset method.

By assigning a property reference, Outlet establishes a connection between the widget and the model object, the affected property belongs to. After this, the widget is able to read and modify the referred property in response to the user interactions. It is also able to adapt the widget appearance, if the value of the referred property has been modified by another widget or by the application logic itself.

property bool ShowCurrent = true;

The property 'ShowCurrent' controls the visibility of the text items displaying the current value.

property color TextColor = Flat::ColorOfTouch;

The property 'TextColor' defines the color of the widgets text members. The property is used to assign a color independent from the current theme color.

method string formatValueString
(
arg int32 aValue
);

Method to format a string based on the given aValue and the current DotPosition and Divisor.

slot onEndSlot;

This internal slot method is used to receive the corresponding signals form the touch handler.

slot onRotateSlot;

This internal slot method is used to receive the corresponding signals form the touch handler.

slot onStartSlot;

This internal slot method is used to receive the corresponding signals form the touch handler.

slot outletSlot;

This slot method will receive a signal, if the value of the property assigned to Outlet has been changed by another widget or by the application logic. In response to this notification, the widget will update itself.

var int32 startValue = 0;

This variable stores the Value at the beginning of the user interaction.