Reference for the Mosaic class WidgetSet::RotaryKnobConfig
This class implements the functionality permitting you to simply customize the look and feel of a 'rotary knob' widget (WidgetSet::RotaryKnob). In the practice, you will create an instance of this class, configure its properties with bitmaps, colors and other relevant attributes according to your design expectations and assign such prepared configuration object to the property 'Appearance' of every affected rotary knob widget. Thereupon the widgets will use the configuration information provided in the object.
During its lifetime the rotary knob remains always in one of the four states: 'disabled', 'default', 'focused' and 'active'. The state 'disabled' is true for every not available rotary knob widget (the property 'Enabled' of the widget is 'false'). Such widgets will ignore all user inputs. The state 'default' determines a rotary knob widget, which is ready to be touched by the user or ready to become focused. As soon as the rotary knob widget becomes focused, it switches in the state 'focused'. In this state the user can control the widget by pressing keys on the keyboard. Finally, the state 'active' is true, if the user actually interacts with the widget (the thumb is pressed). With the configuration object you can specify the appearance of the rotary knob for every state individually. For this purpose you should know from which views the rotary knob is composed of:
All above mentioned views are arranged one above the other whereby the resulting stacking order can be configured by using the properties ScaleStackingPriority, TrackLeftStackingPriority, TrackRightStackingPriority, ThumbStackingPriority, AccentStackingPriority and CoverStackingPriority. The view with higher priority will appear in front of other views with lower priority.
Normally, when a state alternation occurs, the affected views are updated immediatelly to reflect the new state. By using the property StateTransitionDuration it is possible to configure the rotary knob widget to perform state alternations with animations (e.g. the displacement of the thumb shadow can be animated). This affects all attributes of the arc, rectangle, border and shadow views belonging to the thumb, left track, right track and accent. In case of the images displayed in the scale, thumb and cover, the animation has an effect only on the colors and offsets used to configure the views. Consequently, during animations these views can fade-out/in their colors and move only.
If the rotary knob is actually focused, it can also be controlled by pressing the keyboard keys specified in the properties KeyCodeLeft and KeyCodeRight causing the thumb to be rotated counterclockwise or clockwise. To prevent the rotary knob from being able to be focused, initialize these properties with the value Core::KeyCode.NoKey. With the properties KeyRepeatDelay and KeyRepeatPeriod you can configure whether the thumb should be moved autonomously when the user holds the key pressed for a while.
To further enhance the widgets, a slot method can be assigned to the property OnUpdate. Within the slot method new decoration views can be added to the widgets and updated according to the current state of the widget.
With the properties WidgetMinSize and WidgetMaxSize you can configure size constraints for the widget itself. You can, for example, limit the rotary knob to not shrink below a specified width or height.
property color AccentBorderColorActive = #00000000;
The property 'AccentBorderColorActive' determines the color to stroke the border surrounding the accent area when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). To determine the thickness of the border use the property AccentBorderWidthActive.
Please note, in order to be visible, a valid size for the accent area has to be configured in the property AccentSizeActive. With the property AccentCornerRadiusActive the rounding at the corners of the border can be specified.
property color AccentBorderColorDefault = #00000000;
The property 'AccentBorderColorDefault' determines the color to stroke the border surrounding the accent area when the widget is in the 'default' state. To determine the thickness of the border use the property AccentBorderWidthDefault.
Please note, in order to be visible, a valid size for the accent area has to be configured in the property AccentSizeDefault. With the property AccentCornerRadiusDefault the rounding at the corners of the border can be specified.
property color AccentBorderColorDisabled = #00000000;
The property 'AccentBorderColorDisabled' determines the color to stroke the border surrounding the accent area when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). To determine the thickness of the border use the property AccentBorderWidthDisabled.
Please note, in order to be visible, a valid size for the accent area has to be configured in the property AccentSizeDisabled. With the property AccentCornerRadiusDisabled the rounding at the corners of the border can be specified.
property color AccentBorderColorFocused = #00000000;
The property 'AccentBorderColorFocused' determines the color to stroke the border surrounding the accent area when the widget is in the 'focused' state (the widget can react to keyboard events). To determine the thickness of the border use the property AccentBorderWidthFocused.
Please note, in order to be visible, a valid size for the accent area has to be configured in the property AccentSizeFocused. With the property AccentCornerRadiusFocused the rounding at the corners of the border can be specified.
property int32 AccentBorderWidthActive = 0;
The property 'AccentBorderWidthActive' determines the thickness of the border surrounding the accent area when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The value is expressed in pixel. To determine the color of the border use the property AccentBorderColorActive.
Please note, in order to be visible, a valid size for the accent area has to be configured in the property AccentSizeActive. With the property AccentCornerRadiusActive the rounding at the corners of the border can be specified.
property int32 AccentBorderWidthDefault = 0;
The property 'AccentBorderWidthDefault' determines the thickness of the border surrounding the accent area when the widget is in the 'default' state. The value is expressed in pixel. To determine the color of the border use the property AccentBorderColorDefault.
Please note, in order to be visible, a valid size for the accent area has to be configured in the property AccentSizeDefault. With the property AccentCornerRadiusDefault the rounding at the corners of the border can be specified.
property int32 AccentBorderWidthDisabled = 0;
The property 'AccentBorderWidthDisabled' determines the thickness of the border surrounding the accent area when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. To determine the color of the border use the property AccentBorderColorDisabled.
Please note, in order to be visible, a valid size for the accent area has to be configured in the property AccentSizeDisabled. With the property AccentCornerRadiusDisabled the rounding at the corners of the border can be specified.
property int32 AccentBorderWidthFocused = 0;
The property 'AccentBorderWidthFocused' determines the thickness of the border surrounding the accent area when the widget is in the 'focused' state (the widget can react to keyboard events). The value is expressed in pixel. To determine the color of the border use the property AccentBorderColorFocused.
Please note, in order to be visible, a valid size for the accent area has to be configured in the property AccentSizeFocused. With the property AccentCornerRadiusFocused the rounding at the corners of the border can be specified.
property color AccentColorActive = #00000000;
The property 'AccentColorActive' determines the color to fill the background of the accent area when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). In order to be visible, a valid size for the accent has to be configured in the property AccentSizeActive. With the property AccentCornerRadiusActive the rounding at the corners of the filled area can be specified.
property color AccentColorDefault = #00000000;
The property 'AccentColorDefault' determines the color to fill the background of the accent area when the widget is in the 'default' state. In order to be visible, a valid size for the accent has to be configured in the property AccentSizeDefault. With the property AccentCornerRadiusDefault the rounding at the corners of the filled area can be specified.
property color AccentColorDisabled = #00000000;
The property 'AccentColorDisabled' determines the color to fill the background of the accent area when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). In order to be visible, a valid size for the accent has to be configured in the property AccentSizeDisabled. With the property AccentCornerRadiusDisabled the rounding at the corners of the filled area can be specified.
property color AccentColorFocused = #00000000;
The property 'AccentColorFocused' determines the color to fill the background of the accent area when the widget is in the 'focused' state (the widget can react to keyboard events). In order to be visible, a valid size for the accent has to be configured in the property AccentSizeFocused. With the property AccentCornerRadiusFocused the rounding at the corners of the filled area can be specified.
property int32 AccentCornerRadiusActive = 0;
The property 'AccentCornerRadiusActive' controls the rounding at corners of the accent area when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). Normally, the accent area has the shape of a rectangle with sharp corners. Specifying a value greater than 0 in this property rounds the corners. The larger the value, the bigger the rounding effect in the state 'default'. The value is expressed as radius in pixel.
Please note, that the corner radius is automatically limited to half the shorter edge of the rectangle representing the accent area, which corresponds to the setting of the property AccentSizeActive.
property int32 AccentCornerRadiusDefault = 0;
The property 'AccentCornerRadiusDefault' controls the rounding at corners of the accent area when the widget is in the 'default' state. Normally, the accent area has the shape of a rectangle with sharp corners. Specifying a value greater than 0 in this property rounds the corners. The larger the value, the bigger the rounding effect in the state 'default'. The value is expressed as radius in pixel.
Please note, that the corner radius is automatically limited to half the shorter edge of the rectangle representing the accent area, which corresponds to the setting of the property AccentSizeDefault:
property int32 AccentCornerRadiusDisabled = 0;
The property 'AccentCornerRadiusDisabled' controls the rounding at corners of the accent area when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). Normally, the accent area has the shape of a rectangle with sharp corners. Specifying a value greater than 0 in this property rounds the corners. The larger the value, the bigger the rounding effect in the state 'default'. The value is expressed as radius in pixel.
Please note, that the corner radius is automatically limited to half the shorter edge of the rectangle representing the accent area, which corresponds to the setting of the property AccentSizeDisabled.
property int32 AccentCornerRadiusFocused = 0;
The property 'AccentCornerRadiusFocused' controls the rounding at corners of the accent area when the widget is in the 'focused' state (the widget can react to keyboard events). Normally, the accent area has the shape of a rectangle with sharp corners. Specifying a value greater than 0 in this property rounds the corners. The larger the value, the bigger the rounding effect in the state 'default'. The value is expressed as radius in pixel.
Please note, that the corner radius is automatically limited to half the shorter edge of the rectangle representing the accent area, which corresponds to the setting of the property AccentSizeFocused.
property point AccentOffsetActive = <0,0>;
The property 'AccentOffsetActive' determines an additional displacement in pixel for the accent area when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The accent area, composed of a filled rectangle and border is displayed centered at the actual thumb position. The value specified in the property AccentOffsetActive is used to move the accent area accordingly.
Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentSizeActive. In this manner the widget can be configured with an accent area changing its position and size depending on the state of the widget.
property point AccentOffsetDefault = <0,0>;
The property 'AccentOffsetDefault' determines an additional displacement in pixel for the accent area when the widget is in the 'default' state. The accent area, composed of a filled rectangle and border is displayed centered at the actual thumb position. The value specified in the property AccentOffsetDefault is used to move the accent area accordingly.
Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentSizeDefault. In this manner the widget can be configured with an accent area changing its position and size depending on the state of the widget.
property point AccentOffsetDisabled = <0,0>;
The property 'AccentOffsetDisabled' determines an additional displacement in pixel for the accent area when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The accent area, composed of a filled rectangle and border is displayed centered at the actual thumb position. The value specified in the property AccentOffsetDisabled is used to move the accent area accordingly.
Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentSizeDisabled. In this manner the widget can be configured with an accent area changing its position and size depending on the state of the widget.
property point AccentOffsetFocused = <0,0>;
The property 'AccentOffsetFocused' determines an additional displacement in pixel for the accent area when the widget is in the 'focused' state (the widget can react to keyboard events). The accent area, composed of a filled rectangle and border is displayed centered at the actual thumb position. The value specified in the property AccentOffsetFocused is used to move the accent area accordingly.
Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentSizeFocused. In this manner the widget can be configured with an accent area changing its position and size depending on the state of the widget.
property point AccentSizeActive = <0,0>;
The property 'AccentSizeActive' determines the size of the accent area when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The value is expressed in pixel. This area can be composed of a filled rectangle and border.
Besides the possibility to adjust the size, also the position of the accent can be modified by using the associated property AccentOffsetActive. In this manner the widget can be configured with an accent area changing its position and size depending on the state of the widget.
property point AccentSizeDefault = <0,0>;
The property 'AccentSizeDefault' determines the size of the accent area when the widget is in the 'default' state. The value is expressed in pixel. This area can be composed of a filled rectangle and border.
Besides the possibility to adjust the size, also the position of the accent can be modified by using the associated property AccentOffsetDefault. In this manner the widget can be configured with an accent area changing its position and size depending on the state of the widget.
property point AccentSizeDisabled = <0,0>;
The property 'AccentSizeDisabled' determines the size of the accent area when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. This area can be composed of a filled rectangle and border.
Besides the possibility to adjust the size, also the position of the accent can be modified by using the associated property AccentOffsetDisabled. In this manner the widget can be configured with an accent area changing its position and size depending on the state of the widget.
property point AccentSizeFocused = <0,0>;
The property 'AccentSizeFocused' determines the size of the accent area when the widget is in the 'focused' state (the widget can react to keyboard events). The value is expressed in pixel. This area can be composed of a filled rectangle and border.
Besides the possibility to adjust the size, also the position of the accent can be modified by using the associated property AccentOffsetFocused. In this manner the widget can be configured with an accent area changing its position and size depending on the state of the widget.
property int32 AccentStackingPriority = 5;
The property 'AccentStackingPriority' determines the Z-order position of the views destined to display the accent area (rectangle and border). Per default the accent views are arranged in front of the views belonging to the thumb. By configuring this property the arrangement of the views within the widget can be changed whereby views with larger priority will be arranged in front of views with lower priority. For example, to place the accent views just behind the thumb, configure the property with a smaller value.
property point CenterOffset = <0,0>;
The property 'CenterOffset' determines a displacement common for all views belonging to the thumb, accent, left and right tracks. The resulting position serves as the center around it the thumb and accent views are rotated and the track arcs are calculated. Per default, the center position corresponds to the center of the widget. By specifying a value for the property 'CenterOffset' this position moves accordingly. The value is expressed in pixel.
property Resources::Bitmap CoverBitmapActive = null;
The property 'CoverBitmapActive' determines the bitmap to display centered in the foreground of the rotary knob when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on).
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property CoverFrameActive. If the selected bitmap is intended to be animated, ensure that the property CoverFrameActive is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property CoverTintActive. With the property CoverTintActive you can also modulate the opacity of a regular bitmap.
property Resources::Bitmap CoverBitmapDefault = null;
The property 'CoverBitmapDefault' determines the bitmap to display centered in the foreground of the rotary knob when the widget is in the 'default' state.
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property CoverFrameDefault. If the selected bitmap is intended to be animated, ensure that the property CoverFrameDefault is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property CoverTintDefault. With the property CoverTintDefault you can also modulate the opacity of a regular bitmap.
property Resources::Bitmap CoverBitmapDisabled = null;
The property 'CoverBitmapDisabled' determines the bitmap to display centered in the foreground of the rotary knob when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false').
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property CoverFrameDisabled. If the selected bitmap is intended to be animated, ensure that the property CoverFrameDisabled is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property CoverTintDisabled. With the property CoverTintDisabled you can also modulate the opacity of a regular bitmap.
property Resources::Bitmap CoverBitmapFocused = null;
The property 'CoverBitmapFocused' determines the bitmap to display centered in the foreground of the rotary knob when the widget is in the 'focused' state (the widget can react to keyboard events).
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property CoverFrameFocused. If the selected bitmap is intended to be animated, ensure that the property CoverFrameFocused is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property CoverTintFocused. With the property CoverTintFocused you can also modulate the opacity of a regular bitmap.
property int32 CoverFrameActive = -1;
The property 'CoverFrameActive' determines the frame number within the bitmap CoverBitmapActive. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the CoverBitmapActive bitmap is animated, the animation is automatically started as soon as the widget enters the 'active' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property int32 CoverFrameDefault = -1;
The property 'CoverFrameDefault' determines the frame number within the bitmap CoverBitmapDefault. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the CoverBitmapDefault bitmap is animated, the animation is automatically started as soon as the widget enters the 'default' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property int32 CoverFrameDisabled = -1;
The property 'CoverFrameDisabled' determines the frame number within the bitmap CoverBitmapDisabled. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the CoverBitmapDisabled bitmap is animated, the animation is automatically started as soon as the widget enters the 'disabled' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property int32 CoverFrameFocused = -1;
The property 'CoverFrameFocused' determines the frame number within the bitmap CoverBitmapFocused. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the CoverBitmapFocused bitmap is animated, the animation is automatically started as soon as the widget enters the 'focused' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property int32 CoverStackingPriority = 6;
The property 'CoverStackingPriority' determines the Z-order position of the view destined to display the cover bitmap. Per default the cover view is arranged in front of all other views within the rotary knob widget. By configuring this property the arrangement of the views within the widget can be changed whereby views with larger priority will be arranged in front of views with lower priority. For example, to bring the cover view in background of the rotary knob widget, configure the property with a smaller value.
property color CoverTintActive = #FFFFFFFF;
The property 'CoverTintActive' determines the color value to tint or modulate the bitmap specified in the property CoverBitmapActive. The effect of this color value depends on the type of the bitmap:
property color CoverTintDefault = #FFFFFFFF;
The property 'CoverTintDefault' determines the color value to tint or modulate the bitmap specified in the property CoverBitmapDefault. The effect of this color value depends on the type of the bitmap:
property color CoverTintDisabled = #FFFFFFFF;
The property 'CoverTintDisabled' determines the color value to tint or modulate the bitmap specified in the property CoverBitmapDisabled. The effect of this color value depends on the type of the bitmap:
property color CoverTintFocused = #FFFFFFFF;
The property 'CoverTintFocused' determines the color value to tint or modulate the bitmap specified in the property CoverBitmapFocused. The effect of this color value depends on the type of the bitmap:
property Core::KeyCode KeyCodeLeft = Core::KeyCode.Left;
The property 'KeyCodeLeft' determines the key, the rotary knob should react on when it is focused to rotate the thumb one step counterclockwise. In this manner the user can control the widget by using keyboard or hardware buttons.
When the user holds the key pressed for a period longer than the value specified in the property KeyRepeatDelay, the widget starts to rotate the thumb autonomously with speed resulting from the property KeyRepeatPeriod.
If this property is initialized with the value Core::KeyCode.NoKey, the widget will not be able to become focused and it will not receive any keyboard events.
property Core::KeyCode KeyCodeRight = Core::KeyCode.Right;
The property 'KeyCodeRight' determines the key, the rotary knob should react on when it is focused to rotate the thumb one step clockwise. In this manner the user can control the widget by using keyboard or hardware buttons.
When the user holds the key pressed for a period longer than the value specified in the property KeyRepeatDelay, the widget starts to rotate the thumb autonomously with speed resulting from the property KeyRepeatPeriod.
If this property is initialized with the value Core::KeyCode.NoKey, the widget will not be able to become focused and it will not receive any keyboard events.
property int32 KeyRepeatDelay = 0;
The property 'KeyRepeatDelay' determines the delay in milliseconds how long the user has to hold pressed the key (KeyCodeLeft or KeyCodeRight) until the focused rotary knob widget starts to rotate the thumb autonomously. The speed in which the thumb is rotated results from the value specified in the property KeyRepeatPeriod.
property int32 KeyRepeatPeriod = 0;
The property 'KeyRepeatPeriod' determines the delay in milliseconds between two steps the rotary knob widget should move the thumb autonomously when the user holds pressed the key (KeyCodeLeft or KeyCodeRight) longer than the delay specified in the property KeyRepeatDelay.
property slot OnUpdate = null;
The property 'OnUpdate' can refer to a slot method, which should be invoked by widgets connected to this configuration object when the widget's state changes. This method is intended to add and update custom widget decorations.
The usage of this property is equal to the homonymous property explained in WidgetSet::RotaryKnob. See its description for more details.
Please note, when the slot method is invoked, the method's parameter 'sender' refers the widget instance causing the invocation. In this manner, by using 'sender' the implementation of the slot method can access the widget to add and manipulate decoration views.
property Resources::Bitmap ScaleBitmapActive = null;
The property 'ScaleBitmapActive' determines the bitmap to display centered in the background of the rotary knob when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on).
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property ScaleFrameActive. If the selected bitmap is intended to be animated, ensure that the property ScaleFrameActive is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property ScaleTintActive. With the property ScaleTintActive you can also modulate the opacity of a regular bitmap.
property Resources::Bitmap ScaleBitmapDefault = null;
The property 'ScaleBitmapDefault' determines the bitmap to display centered in the background of the rotary knob when the widget is in the 'default' state.
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property ScaleFrameDefault. If the selected bitmap is intended to be animated, ensure that the property ScaleFrameDefault is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property ScaleTintDefault. With the property ScaleTintDefault you can also modulate the opacity of a regular bitmap.
property Resources::Bitmap ScaleBitmapDisabled = null;
The property 'ScaleBitmapDisabled' determines the bitmap to display centered in the background of the rotary knob when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false').
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property ScaleFrameDisabled. If the selected bitmap is intended to be animated, ensure that the property ScaleFrameDisabled is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property ScaleTintDisabled. With the property ScaleTintDisabled you can also modulate the opacity of a regular bitmap.
property Resources::Bitmap ScaleBitmapFocused = null;
The property 'ScaleBitmapFocused' determines the bitmap to display centered in the background of the rotary knob when the widget is in the 'focused' state (the widget can react to keyboard events).
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property ScaleFrameFocused. If the selected bitmap is intended to be animated, ensure that the property ScaleFrameFocused is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property ScaleTintFocused. With the property ScaleTintFocused you can also modulate the opacity of a regular bitmap.
property int32 ScaleFrameActive = -1;
The property 'ScaleFrameActive' determines the frame number within the bitmap ScaleBitmapActive. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the ScaleBitmapActive bitmap is animated, the animation is automatically started as soon as the widget enters the 'active' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property int32 ScaleFrameDefault = -1;
The property 'ScaleFrameDefault' determines the frame number within the bitmap ScaleBitmapDefault. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the ScaleBitmapDefault bitmap is animated, the animation is automatically started as soon as the widget enters the 'default' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property int32 ScaleFrameDisabled = -1;
The property 'ScaleFrameDisabled' determines the frame number within the bitmap ScaleBitmapDisabled. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the ScaleBitmapDisabled bitmap is animated, the animation is automatically started as soon as the widget enters the 'disabled' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property int32 ScaleFrameFocused = -1;
The property 'ScaleFrameFocused' determines the frame number within the bitmap ScaleBitmapFocused. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the ScaleBitmapFocused bitmap is animated, the animation is automatically started as soon as the widget enters the 'focused' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property int32 ScaleStackingPriority = 1;
The property 'ScaleStackingPriority' determines the Z-order position of the view destined to display the scale bitmap. Per default the scale view is arranged in the background of the rotary knob widget behind all other views. By configuring this property the arrangement of the views within the widget can be changed whereby views with larger priority will be arranged in front of views with lower priority. For example, to bring the scale view in front of the rotary knob widget, configure the property with a larger value.
property color ScaleTintActive = #FFFFFFFF;
The property 'ScaleTintActive' determines the color value to tint or modulate the bitmap specified in the property ScaleBitmapActive. The effect of this color value depends on the type of the bitmap:
property color ScaleTintDefault = #FFFFFFFF;
The property 'ScaleTintDefault' determines the color value to tint or modulate the bitmap specified in the property ScaleBitmapDefault. The effect of this color value depends on the type of the bitmap:
property color ScaleTintDisabled = #FFFFFFFF;
The property 'ScaleTintDisabled' determines the color value to tint or modulate the bitmap specified in the property ScaleBitmapDisabled. The effect of this color value depends on the type of the bitmap:
property color ScaleTintFocused = #FFFFFFFF;
The property 'ScaleTintFocused' determines the color value to tint or modulate the bitmap specified in the property ScaleBitmapFocused. The effect of this color value depends on the type of the bitmap:
property int32 StateTransitionDuration = 0;
The property 'StateTransitionDuration' controls how long do animations take when the state of the rotary knob widget changes. In this manner the appearance of the widget is updated smoothly (e.g. the thumb shadow is faded-out) instead of being performed abruptly. This value is expressed in milliseconds. If this value is 0 (zero), no animations are performed.
Animations affect all attributes of the filled arc, rectangle, border and shadow views belonging to the thumb, left track, right track and accent areas. In case of the images displayed in the scale, thumb and cover, the animation has an effect only on the colors and offsets used to configure the views. Consequently, during animations these views can fade-out/in their colors and move only.
property Resources::Bitmap ThumbBitmapActive = null;
The property 'ThumbBitmapActive' determines the bitmap to display rotated around the center of the rotary knob widget when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on).
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property ThumbFrameActive. If the selected bitmap is intended to be animated, ensure that the property ThumbFrameActive is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property ThumbTintActive. With the property ThumbTintActive you can also modulate the opacity of a regular bitmap.
With the properties CenterOffset, ThumbRadiusActive and ThumbPivot you adjust the position around it the thumb bitmap should rotate. The possible rotation range is determined by the properties ThumbMinAngle and ThumbMaxAngle. To simplify the configuration of ThumbMinAngle and ThumbMaxAngle we recommend to design the thumb bitmap for 0 degrees rotation relative to the positive X-axis. With the property ThumbOffsetActive the position of the displayed image can be adjusted additionally.
property Resources::Bitmap ThumbBitmapDefault = null;
The property 'ThumbBitmapDefault' determines the bitmap to display rotated around the center of the rotary knob widget when the widget is in the 'default' state.
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property ThumbFrameDefault. If the selected bitmap is intended to be animated, ensure that the property ThumbFrameDefault is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property ThumbTintDefault. With the property ThumbTintDefault you can also modulate the opacity of a regular bitmap.
With the properties CenterOffset, ThumbRadiusDefault and ThumbPivot you adjust the position around it the thumb bitmap should rotate. The possible rotation range is determined by the properties ThumbMinAngle and ThumbMaxAngle. To simplify the configuration of ThumbMinAngle and ThumbMaxAngle we recommend to design the thumb bitmap for 0 degrees rotation relative to the positive X-axis. With the property ThumbOffsetDefault the position of the displayed image can be adjusted additionally.
property Resources::Bitmap ThumbBitmapDisabled = null;
The property 'ThumbBitmapDisabled' determines the bitmap to display rotated around the center of the rotary knob widget when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false').
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property ThumbFrameDisabled. If the selected bitmap is intended to be animated, ensure that the property ThumbFrameDisabled is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property ThumbTintDisabled. With the property ThumbTintDisabled you can also modulate the opacity of a regular bitmap.
With the properties CenterOffset, ThumbRadiusDisabled and ThumbPivot you adjust the position around it the thumb bitmap should rotate. The possible rotation range is determined by the properties ThumbMinAngle and ThumbMaxAngle. To simplify the configuration of ThumbMinAngle and ThumbMaxAngle we recommend to design the thumb bitmap for 0 degrees rotation relative to the positive X-axis. With the property ThumbOffsetDisabled the position of the displayed image can be adjusted additionally.
property Resources::Bitmap ThumbBitmapFocused = null;
The property 'ThumbBitmapFocused' determines the bitmap to display rotated around the center of the rotary knob widget when the widget is in the 'focused' state (the widget can react to keyboard events).
If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property ThumbFrameFocused. If the selected bitmap is intended to be animated, ensure that the property ThumbFrameFocused is -1.
If the specified bitmap contains opacity information only (Alpha8 bitmap), you can tint the bitmap by specifying the desired color in the property ThumbTintFocused. With the property ThumbTintFocused you can also modulate the opacity of a regular bitmap.
With the properties CenterOffset, ThumbRadiusFocused and ThumbPivot you adjust the position around it the thumb bitmap should rotate. The possible rotation range is determined by the properties ThumbMinAngle and ThumbMaxAngle. To simplify the configuration of ThumbMinAngle and ThumbMaxAngle we recommend to design the thumb bitmap for 0 degrees rotation relative to the positive X-axis. With the property ThumbOffsetFocused the position of the displayed image can be adjusted additionally.
property color ThumbBorderColorActive = #00000000;
The property 'ThumbBorderColorActive' determines the color to stroke the border surrounding the thumb when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). To determine the thickness of the border use the property ThumbBorderWidthActive.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeActive. With the property ThumbCornerRadiusActive the rounding at the corners of the border can be specified.
property color ThumbBorderColorDefault = #00000000;
The property 'ThumbBorderColorDefault' determines the color to stroke the border surrounding the thumb when the widget is in the 'default' state. To determine the thickness of the border use the property ThumbBorderWidthDefault.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDefault. With the property ThumbCornerRadiusDefault the rounding at the corners of the border can be specified.
property color ThumbBorderColorDisabled = #00000000;
The property 'ThumbBorderColorDisabled' determines the color to stroke the border surrounding the thumb when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). To determine the thickness of the border use the property ThumbBorderWidthDisabled.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDisabled. With the property ThumbCornerRadiusDisabled the rounding at the corners of the border can be specified.
property color ThumbBorderColorFocused = #00000000;
The property 'ThumbBorderColorFocused' determines the color to stroke the border surrounding the thumb when the widget is in the 'focused' state (the widget can react to keyboard events). To determine the thickness of the border use the property ThumbBorderWidthFocused.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeFocused. With the property ThumbCornerRadiusFocused the rounding at the corners of the border can be specified.
property int32 ThumbBorderWidthActive = 0;
The property 'ThumbBorderWidthActive' determines the thickness of the border surrounding the thumb when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The value is expressed in pixel. To determine the color of the border use the property ThumbBorderColorActive.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeActive. With the property ThumbCornerRadiusActive the rounding at the corners of the border can be specified.
property int32 ThumbBorderWidthDefault = 0;
The property 'ThumbBorderWidthDefault' determines the thickness of the border surrounding the thumb when the widget is in the 'default' state. The value is expressed in pixel. To determine the color of the border use the property ThumbBorderColorDefault.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDefault. With the property ThumbCornerRadiusDefault the rounding at the corners of the border can be specified.
property int32 ThumbBorderWidthDisabled = 0;
The property 'ThumbBorderWidthDisabled' determines the thickness of the border surrounding the thumb when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. To determine the color of the border use the property ThumbBorderColorDisabled.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDisabled. With the property ThumbCornerRadiusDisabled the rounding at the corners of the border can be specified.
property int32 ThumbBorderWidthFocused = 0;
The property 'ThumbBorderWidthFocused' determines the thickness of the border surrounding the thumb when the widget is in the 'focused' state (the widget can react to keyboard events). The value is expressed in pixel. To determine the color of the border use the property ThumbBorderColorFocused.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeFocused. With the property ThumbCornerRadiusFocused the rounding at the corners of the border can be specified.
property color ThumbColorActive = #00000000;
The property 'ThumbColorActive' determines the color to fill the background of the thumb when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). In order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeActive. With the property ThumbCornerRadiusActive the rounding at the corners of the filled area can be specified.
property color ThumbColorDefault = #00000000;
The property 'ThumbColorDefault' determines the color to fill the background of the thumb when the widget is in the 'default' state. In order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDefault. With the property ThumbCornerRadiusDefault the rounding at the corners of the filled area can be specified.
property color ThumbColorDisabled = #00000000;
The property 'ThumbColorDisabled' determines the color to fill the background of the thumb when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). In order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDisabled. With the property ThumbCornerRadiusDisabled the rounding at the corners of the filled area can be specified.
property color ThumbColorFocused = #00000000;
The property 'ThumbColorFocused' determines the color to fill the background of the thumb when the widget is in the 'focused' state (the widget can react to keyboard events). In order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeFocused. With the property ThumbCornerRadiusFocused the rounding at the corners of the filled area can be specified.
property int32 ThumbCornerRadiusActive = 0;
The property 'ThumbCornerRadiusActive' controls the rounding at corners of a filled rectangle, border and shadow belonging to the thumb when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). Normally, the thumb has the shape of a rectangle with sharp corners. Specifying a value greater than 0 in this property rounds the corners. The larger the value, the bigger the rounding effect in the state 'active'. The value is expressed as radius in pixel.
Please note, that the corner radius is automatically limited to half the shorter edge of the rectangle representing the thumb. The size of the thumb is determined by the property ThumbSizeActive.
property int32 ThumbCornerRadiusDefault = 0;
The property 'ThumbCornerRadiusDefault' controls the rounding at corners of a filled rectangle, border and shadow belonging to the thumb when the widget is in the 'default' state. Normally, the thumb has the shape of a rectangle with sharp corners. Specifying a value greater than 0 in this property rounds the corners. The larger the value, the bigger the rounding effect in the state 'default'. The value is expressed as radius in pixel.
Please note, that the corner radius is automatically limited to half the shorter edge of the rectangle representing the thumb. The size of the thumb is determined by the property ThumbSizeDefault:
property int32 ThumbCornerRadiusDisabled = 0;
The property 'ThumbCornerRadiusDisabled' controls the rounding at corners of a filled rectangle, border and shadow belonging to the thumb when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). Normally, the thumb has the shape of a rectangle with sharp corners. Specifying a value greater than 0 in this property rounds the corners. The larger the value, the bigger the rounding effect in the state 'disabled'. The value is expressed as radius in pixel.
Please note, that the corner radius is automatically limited to half the shorter edge of the rectangle representing the thumb. The size of the thumb is determined by the property ThumbSizeDisabled.
property int32 ThumbCornerRadiusFocused = 0;
The property 'ThumbCornerRadiusFocused' controls the rounding at corners of a filled rectangle, border and shadow belonging to the thumb when the widget is in the 'focused' state (the widget can react to keyboard events). Normally, the thumb has the shape of a rectangle with sharp corners. Specifying a value greater than 0 in this property rounds the corners. The larger the value, the bigger the rounding effect in the state 'focused'. The value is expressed as radius in pixel.
Please note, that the corner radius is automatically limited to half the shorter edge of the rectangle representing the thumb. The size of the thumb is determined by the property ThumbSizeFocused.
property int32 ThumbFrameActive = -1;
The property 'ThumbFrameActive' determines the frame number within the bitmap ThumbBitmapActive. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the ThumbBitmapActive bitmap is animated, the animation is automatically started as soon as the widget enters the 'active' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property int32 ThumbFrameDefault = -1;
The property 'ThumbFrameDefault' determines the frame number within the bitmap ThumbBitmapDefault. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the ThumbBitmapDefault bitmap is animated, the animation is automatically started as soon as the widget enters the 'default' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property int32 ThumbFrameDisabled = -1;
The property 'ThumbFrameDisabled' determines the frame number within the bitmap ThumbBitmapDisabled. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the ThumbBitmapDisabled bitmap is animated, the animation is automatically started as soon as the widget enters the 'disabled' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property int32 ThumbFrameFocused = -1;
The property 'ThumbFrameFocused' determines the frame number within the bitmap ThumbBitmapFocused. This property is applicable for multi-frame bitmaps only (see also Resources::Bitmap). If the desired frame is not available in the bitmap, no bitmap is shown.
If the property is initialized with the value -1 and the ThumbBitmapFocused bitmap is animated, the animation is automatically started as soon as the widget enters the 'focused' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.
property float ThumbMaxAngle = 45;
The property 'ThumbMaxAngle' determines the rotation angle for the thumb (composed of an image, filled rectangle, border and shadow) corresponding to 'MaxValue' specified in the rotary knob widget. The angle is expressed in degree, counted counterclockwise with 0 degree at the positive X-axis.
At the runtime, when the value stored in the rotary knob widget changes, the thumb will move (rotate) accordingly in the range between the angle position ThumbMinAngle and 'ThumbMaxAngle'. The rotation occurs around the center position of the rotary knob widget unless a displacement has been specified in the property CenterOffset. The rotation radius is determined by the properties ThumbRadiusDefault, ThumbRadiusDisabled, ThumbRadiusFocused and ThumbRadiusActive.
Please note, the value specified in 'ThumbMaxAngle' has to be less than the value specified in ThumbMinAngle.
property float ThumbMinAngle = 135;
The property 'ThumbMinAngle' determines the rotation angle for the thumb (composed of an image, filled rectangle, border and shadow) corresponding to 'MinValue' specified in the rotary knob widget. The angle is expressed in degree, counted counterclockwise with 0 degree at the positive X-axis.
At the runtime, when the value stored in the rotary knob widget changes, the thumb will move (rotate) accordingly in the range between the angle position 'ThumbMinAngle' and ThumbMaxAngle. The rotation occurs around the center position of the rotary knob widget unless a displacement has been specified in the property CenterOffset. The rotation radius is determined by the properties ThumbRadiusDefault, ThumbRadiusDisabled, ThumbRadiusFocused and ThumbRadiusActive.
Please note, the value specified in 'ThumbMinAngle' has to be greater than the value specified in ThumbMaxAngle.
property point ThumbOffsetActive = <0,0>;
The property 'ThumbOffsetActive' determines an additional displacement in pixel for all views belonging to thumb (filled rectangle, border, shadow and image) when the rotary knob widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The value specified in the property ThumbOffsetActive allows the thumb to be moved accordingly.
Please note, the filled rectangle, border and shadow views belonging to the thumb are per default centered at the actual thumb position. In case of the thumb displaying an image (ThumbBitmapActive), the image is not centered. Instead the position within the image has to be configured explicitly by the property ThumbPivot.
Besides the possibility to adjust the position, also the size of the filled rectangle, border and shadow belonging to the thumb can be modified by using the associated property ThumbSizeActive. In this manner the widget can be configured with a thumb changing its position and size depending on the state of the widget.
property point ThumbOffsetDefault = <0,0>;
The property 'ThumbOffsetDefault' determines an additional displacement in pixel for all views belonging to thumb (filled rectangle, border, shadow and image) when the rotary knob widget is in the 'default' state. The value specified in the property ThumbOffsetDefault allows the thumb to be moved accordingly.
Please note, the filled rectangle, border and shadow views belonging to the thumb are per default centered at the actual thumb position. In case of the thumb displaying an image (ThumbBitmapDefault), the image is not centered. Instead the position within the image has to be configured explicitly by the property ThumbPivot.
Besides the possibility to adjust the position, also the size of the filled rectangle, border and shadow belonging to the thumb can be modified by using the associated property ThumbSizeDefault. In this manner the widget can be configured with a thumb changing its position and size depending on the state of the widget.
property point ThumbOffsetDisabled = <0,0>;
The property 'ThumbOffsetDisabled' determines an additional displacement in pixel for all views belonging to thumb (filled rectangle, border, shadow and image) when the rotary knob widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value specified in the property ThumbOffsetDisabled allows the thumb to be moved accordingly.
Please note, the filled rectangle, border and shadow views belonging to the thumb are per default centered at the actual thumb position. In case of the thumb displaying an image (ThumbBitmapDisabled), the image is not centered. Instead the position within the image has to be configured explicitly by the property ThumbPivot.
Besides the possibility to adjust the position, also the size of the filled rectangle, border and shadow belonging to the thumb can be modified by using the associated property ThumbSizeDisabled. In this manner the widget can be configured with a thumb changing its position and size depending on the state of the widget.
property point ThumbOffsetFocused = <0,0>;
The property 'ThumbOffsetFocused' determines an additional displacement in pixel for all views belonging to thumb (filled rectangle, border, shadow and image) when the rotary knob widget is in the 'focused' state (the widget can react to keyboard events). The value specified in the property ThumbOffsetFocused allows the thumb to be moved accordingly.
Please note, the filled rectangle, border and shadow views belonging to the thumb are per default centered at the actual thumb position. In case of the thumb displaying an image (ThumbBitmapFocused), the image is not centered. Instead the position within the image has to be configured explicitly by the property ThumbPivot.
Besides the possibility to adjust the position, also the size of the filled rectangle, border and shadow belonging to the thumb can be modified by using the associated property ThumbSizeFocused. In this manner the widget can be configured with a thumb changing its position and size depending on the state of the widget.
property point ThumbPivot = <0,0>;
The property 'ThumbPivot' specifies the pivot position (the anchor) in the thumb bitmap (ThumbBitmapActive, ThumbBitmapDefault, ThumbBitmapDisabled or ThumbBitmapFocused) around it the thumb bitmap should be rotated. The position is expressed in pixel relative to the top-left corner of the thumb bitmap.
To simplify the configuration of the widget, we recommend to design the thumb bitmap for 0 degrees rotation relative to the positive X-axis. See also ThumbRadiusDefault, ThumbRadiusDisabled, ThumbRadiusFocused, ThumbRadiusActive, ThumbRotate and CenterOffset.
Please note, the property 'ThumbPivot' has no effect on the position of the filled rectangle, border and shadow views belonging to the thumb. These views are always arranged at their own center positions. The position of the thumb can additionally be adjusted by using the properties ThumbOffsetActive, ThumbOffsetDefault, ThumbOffsetDisabled, ThumbOffsetFocused.
property float ThumbRadiusActive = 0.0;
The property 'ThumbRadiusActive' specifies the radius of the circle segment along which the thumb (composed of an image, filled rectangle, border and shadow) should be moved when the widget is in the 'active' state (the user is actually touching the widget or pressing a key on the keyboard the widget should react on). The value is expressed in pixel. The center of the circle segment corresponds to the position resulting from the property CenterOffset. The movement range is determined by the properties ThumbMinAngle and ThumbMaxAngle.
Please note, the property ThumbOffsetActive additionally affects the position of the views belonging to the thumb. In case of the thumb displaying an image (configured in the property ThumbBitmapActive), further rotation parameters for the image can be specified in the properties ThumbPivot and ThumbRotate.
property float ThumbRadiusDefault = 0.0;
The property 'ThumbRadiusDefault' specifies the radius of the circle segment along which the thumb (composed of an image, filled rectangle, border and shadow) should be moved when the widget is in the 'default' state. The value is expressed in pixel. The center of the circle segment corresponds to the position resulting from the property CenterOffset. The movement range is determined by the properties ThumbMinAngle and ThumbMaxAngle.
Please note, the property ThumbOffsetDefault additionally affects the position of the views belonging to the thumb. In case of the thumb displaying an image (configured in the property ThumbBitmapDefault), further rotation parameters for the image can be specified in the properties ThumbPivot and ThumbRotate.
property float ThumbRadiusDisabled = 0.0;
The property 'ThumbRadiusDisabled' specifies the radius of the circle segment along which the thumb (composed of an image, filled rectangle, border and shadow) should be moved when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. The center of the circle segment corresponds to the position resulting from the property CenterOffset. The movement range is determined by the properties ThumbMinAngle and ThumbMaxAngle.
Please note, the property ThumbOffsetDisabled additionally affects the position of the views belonging to the thumb. In case of the thumb displaying an image (configured in the property ThumbBitmapDisabled), further rotation parameters for the image can be specified in the properties ThumbPivot and ThumbRotate.
property float ThumbRadiusFocused = 0.0;
The property 'ThumbRadiusFocused' specifies the radius of the circle segment along which the thumb (composed of an image, filled rectangle, border and shadow) should be moved when the widget is in the 'focused' state (the widget can react to keyboard events). The value is expressed in pixel. The center of the circle segment corresponds to the position resulting from the property CenterOffset. The movement range is determined by the properties ThumbMinAngle and ThumbMaxAngle.
Please note, the property ThumbOffsetFocused additionally affects the position of the views belonging to the thumb. In case of the thumb displaying an image (configured in the property ThumbBitmapFocused), further rotation parameters for the image can be specified in the properties ThumbPivot and ThumbRotate.
property bool ThumbRotate = true;
The property 'ThumbRotate' determines whether the thumb bitmap (ThumbBitmapActive, ThumbBitmapDefault, ThumbBitmapDisabled or ThumbBitmapFocused) should appear rotated or not. If this property is 'true', the bitmap is rotated around its ThumbPivot and moved along the circle segment with radius configured in the properties ThumbRadiusActive, ThumbRadiusDefault, ThumbRadiusDisabled, ThumbRadiusFocused. If this property is 'false', the bitmap is only moved along the circle segment without being rotated itself.
Please note, the property 'ThumbRotate' has no effect on the orientation of the filled rectangle, border and shadow views belonging to the thumb. These views are not rotated themselves.
property int32 ThumbShadowBlurRadiusActive = 0;
The property 'ThumbShadowBlurRadiusActive' determines the blur radius of the shadow behind the thumb when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The value is expressed in pixel and it is limitted to 64 pixel. To determine the color of the shadow use the property ThumbShadowColorActive.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeActive. With the property ThumbCornerRadiusActive the rounding at the corners of the shadow shape can be specified.
property int32 ThumbShadowBlurRadiusDefault = 0;
The property 'ThumbShadowBlurRadiusDefault' determines the blur radius of the shadow behind the thumb when the widget is in the 'default' state. The value is expressed in pixel and it is limitted to 64 pixel. To determine the color of the shadow use the property ThumbShadowColorDefault.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDefault. With the property ThumbCornerRadiusDefault the rounding at the corners of the shadow shape can be specified.
property int32 ThumbShadowBlurRadiusDisabled = 0;
The property 'ThumbShadowBlurRadiusDisabled' determines the blur radius of the shadow behind the thumb when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel and it is limitted to 64 pixel. To determine the color of the shadow use the property ThumbShadowColorDisabled.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDisabled. With the property ThumbCornerRadiusDisabled the rounding at the corners of the shadow shape can be specified.
property int32 ThumbShadowBlurRadiusFocused = 0;
The property 'ThumbShadowBlurRadiusFocused' determines the blur radius of the shadow behind the thumb when the widget is in the 'focused' state (the widget can react to keyboard events). The value is expressed in pixel and it is limitted to 64 pixel. To determine the color of the shadow use the property ThumbShadowColorFocused.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeFocused. With the property ThumbCornerRadiusFocused the rounding at the corners of the shadow shape can be specified.
property color ThumbShadowColorActive = #00000000;
The property 'ThumbShadowColorActive' determines the color of the shadow behind the thumb when the widget is in the 'active' state (the user is actually touching the widget or pressing a key on the keyboard the widget should react on).
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeActive. With the property ThumbCornerRadiusActive the rounding at the corners of the shadow shape can be specified.
property color ThumbShadowColorDefault = #00000000;
The property 'ThumbShadowColorDefault' determines the color of the shadow behind the thumb when the widget is in the 'default' state.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDefault. With the property ThumbCornerRadiusDefault the rounding at the corners of the shadow shape can be specified.
property color ThumbShadowColorDisabled = #00000000;
The property 'ThumbShadowColorDisabled' determines the color of the shadow behind the thumb when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false').
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDisabled. With the property ThumbCornerRadiusDisabled the rounding at the corners of the shadow shape can be specified.
property color ThumbShadowColorFocused = #00000000;
The property 'ThumbShadowColorFocused' determines the color of the shadow behind the thumb when the widget is in the 'focused' state (the widget can react to keyboard events).
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeFocused. With the property ThumbCornerRadiusFocused the rounding at the corners of the shadow shape can be specified.
property point ThumbShadowOffsetActive = <0,0>;
The property 'ThumbShadowOffsetActive' determines the displacement of the shadow behind the thumb when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The value is expressed in pixel. To determine the color of the shadow use the property ThumbShadowColorActive.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeActive. With the property ThumbCornerRadiusActive the rounding at the corners of the shadow shape can be specified.
property point ThumbShadowOffsetDefault = <0,0>;
The property 'ThumbShadowOffsetDefault' determines the displacement of the shadow behind the thumb when the widget is in the 'default' state. The value is expressed in pixel. To determine the color of the shadow use the property ThumbShadowColorDefault.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDefault. With the property ThumbCornerRadiusDefault the rounding at the corners of the shadow shape can be specified.
property point ThumbShadowOffsetDisabled = <0,0>;
The property 'ThumbShadowOffsetDisabled' determines the displacement of the shadow behind the thumb when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. To determine the color of the shadow use the property ThumbShadowColorDisabled.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeDisabled. With the property ThumbCornerRadiusDisabled the rounding at the corners of the shadow shape can be specified.
property point ThumbShadowOffsetFocused = <0,0>;
The property 'ThumbShadowOffsetFocused' determines the displacement of the shadow behind the thumb when the widget is in the 'focused' state (the widget can react to keyboard events). The value is expressed in pixel. To determine the color of the shadow use the property ThumbShadowColorFocused.
Please note, in order to be visible, a valid size for the thumb has to be configured in the property ThumbSizeFocused. With the property ThumbCornerRadiusFocused the rounding at the corners of the shadow shape can be specified.
property point ThumbSizeActive = <0,0>;
The property 'ThumbSizeActive' determines the size of the filled rectangle, border and shadow belonging to the thumb when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). Please note, if the thumb is configured to display an image, the value specified in this property has no effect on the size of the image. The size of the image is imposed by the associated bitmap only (property ThumbBitmapActive).
Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOffsetActive. In this manner the widget can be configured with a thumb changing its position and size depending on the state of the widget.
property point ThumbSizeDefault = <0,0>;
The property 'ThumbSizeDefault' determines the size of the filled rectangle, border and shadow belonging to the thumb when the widget is in the 'default' state. The value is expressed in pixel. Please note, if the thumb is configured to display an image, the value specified in this property has no effect on the size of the image. The size of the image is imposed by the associated bitmap only (property ThumbBitmapDefault).
Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOffsetDefault. In this manner the widget can be configured with a thumb changing its position and size depending on the state of the widget.
property point ThumbSizeDisabled = <0,0>;
The property 'ThumbSizeDisabled' determines the size of the filled rectangle, border and shadow belonging to the thumb when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. Please note, if the thumb is configured to display an image, the value specified in this property has no effect on the size of the image. The size of the image is imposed by the associated bitmap only (property ThumbBitmapDisabled).
Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOffsetDisabled. In this manner the widget can be configured with a thumb changing its position and size depending on the state of the widget.
property point ThumbSizeFocused = <0,0>;
The property 'ThumbSizeFocused' determines the size of the filled rectangle, border and shadow belonging to the thumb when the widget is in the 'focused' state (the widget can react to keyboard events). The value is expressed in pixel. Please note, if the thumb is configured to display an image, the value specified in this property has no effect on the size of the image. The size of the image is imposed by the associated bitmap only (property ThumbBitmapFocused).
Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOffsetFocused. In this manner the widget can be configured with a thumb changing its position and size depending on the state of the widget.
property int32 ThumbStackingPriority = 4;
The property 'ThumbStackingPriority' determines the Z-order position of the views destined to display the thumb (filled rectangle, border, shadow and image). Per default the thumb views are arranged in front of the views belonging to the left and right tracks. By configuring this property the arrangement of the views within the widget can be changed whereby views with larger priority will be arranged in front of views with lower priority. For example, to place the thumb in background of the rotary knob widget, configure the property with a smaller value.
property color ThumbTintActive = #FFFFFFFF;
The property 'ThumbTintActive' determines the color value to tint or modulate the bitmap specified in the property ThumbBitmapActive. The effect of this color value depends on the type of the bitmap:
property color ThumbTintDefault = #FFFFFFFF;
The property 'ThumbTintDefault' determines the color value to tint or modulate the bitmap specified in the property ThumbBitmapDefault. The effect of this color value depends on the type of the bitmap:
property color ThumbTintDisabled = #FFFFFFFF;
The property 'ThumbTintDisabled' determines the color value to tint or modulate the bitmap specified in the property ThumbBitmapDisabled. The effect of this color value depends on the type of the bitmap:
property color ThumbTintFocused = #FFFFFFFF;
The property 'ThumbTintFocused' determines the color value to tint or modulate the bitmap specified in the property ThumbBitmapFocused. The effect of this color value depends on the type of the bitmap:
property color TrackLeftBorderColorActive = #00000000;
The property 'TrackLeftBorderColorActive' determines the color of the border surrounding the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). To determine the thickness of the border use the property TrackLeftBorderWidthActive. See also TrackLeftRadiusActive, TrackLeftThicknessActive, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property color TrackLeftBorderColorDefault = #00000000;
The property 'TrackLeftBorderColorDefault' determines the color of the border surrounding the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'default' state. To determine the thickness of the border use the property TrackLeftBorderWidthDefault. See also TrackLeftRadiusDefault, TrackLeftThicknessDefault, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property color TrackLeftBorderColorDisabled = #00000000;
The property 'TrackLeftBorderColorDisabled' determines the color of the border surrounding the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). To determine the thickness of the border use the property TrackLeftBorderWidthDisabled. See also TrackLeftRadiusDisabled, TrackLeftThicknessDisabled, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property color TrackLeftBorderColorFocused = #00000000;
The property 'TrackLeftBorderColorFocused' determines the color of the border surrounding the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'focused' state (the widget can react to keyboard events). To determine the thickness of the border use the property TrackLeftBorderWidthFocused. See also TrackLeftRadiusFocused, TrackLeftThicknessFocused, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property float TrackLeftBorderWidthActive = 0.0;
The property 'TrackLeftBorderWidthActive' determines the thickness of the border surrounding the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The value is expressed in pixel. To determine the color of the border use the property TrackLeftBorderColorActive. See also TrackLeftRadiusActive, TrackLeftThicknessActive, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property float TrackLeftBorderWidthDefault = 0.0;
The property 'TrackLeftBorderWidthDefault' determines the thickness of the border surrounding the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'default' state. The value is expressed in pixel. To determine the color of the border use the property TrackLeftBorderColorDefault. See also TrackLeftRadiusDefault, TrackLeftThicknessDefault, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property float TrackLeftBorderWidthDisabled = 0.0;
The property 'TrackLeftBorderWidthDisabled' determines the thickness of the border surrounding the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. To determine the color of the border use the property TrackLeftBorderColorDisabled. See also TrackLeftRadiusDisabled, TrackLeftThicknessDisabled, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property float TrackLeftBorderWidthFocused = 0.0;
The property 'TrackLeftBorderWidthFocused' determines the thickness of the border surrounding the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'focused' state (the widget can react to keyboard events). The value is expressed in pixel. To determine the color of the border use the property TrackLeftBorderColorFocused. See also TrackLeftRadiusFocused, TrackLeftThicknessFocused, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property color TrackLeftColorActive = #FFFFFFFF;
The property 'TrackLeftColorActive' determines the color of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). See also TrackLeftRadiusActive, TrackLeftThicknessActive, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property color TrackLeftColorDefault = #FFFFFFFF;
The property 'TrackLeftColorDefault' determines the color of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'default' state. See also TrackLeftRadiusDefault, TrackLeftThicknessDefault, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property color TrackLeftColorDisabled = #FFFFFFFF;
The property 'TrackLeftColorDisabled' determines the color of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). See also TrackLeftRadiusDisabled, TrackLeftThicknessDisabled, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property color TrackLeftColorFocused = #FFFFFFFF;
The property 'TrackLeftColorFocused' determines the color of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'focused' state (the widget can react to keyboard events). See also TrackLeftRadiusFocused, TrackLeftThicknessFocused, TrackLeftRoundedEnd, TrackLeftRoundedStart, TrackLeftMarginEnd and TrackLeftMarginStart.
property float TrackLeftMarginEnd = 0.0;
The property 'TrackLeftMarginEnd' adjusts the end position of the left track relative to the end of the thumb movement range. The movement range is determined by the properties ThumbMinAngle and ThumbMaxAngle. Configuring this property with a negative value causes the track to end beyond (outside) the thumb movement range. The margin is expressed in degree.
Usually the end of the left track corresponds to the actual thumb position. When the thumb is moved, the length of the track is adjusted accordingly. By using this property, the tracks's end position can be limited to not exceed the predetermined angle. To adjust the start position of the track, use the property TrackLeftMarginStart.
The left track (composed of a filled arc and border surrounding it) is arranged relative to the center position of the rotary knob widget with radius configured in the properties TrackLeftRadiusActive, TrackLeftRadiusDefault, TrackLeftRadiusDisabled, TrackLeftRadiusFocused. An optional displacement can be specified in the property CenterOffset. With the property TrackLeftStatic the left track can be configured to not depend on the actual thumb position.
property float TrackLeftMarginStart = 0.0;
The property 'TrackLeftMarginStart' adjusts the start position of the left track relative to the start of the thumb movement range. The movement range is determined by the properties ThumbMinAngle and ThumbMaxAngle. Configuring this property with a negative value causes the track to start beyond (outside) the thumb movement range. The margin is expressed in degree.
The left track (composed of a filled arc and border surrounding it) is arranged relative to the center position of the rotary knob widget with radius configured in the properties TrackLeftRadiusActive, TrackLeftRadiusDefault, TrackLeftRadiusDisabled, TrackLeftRadiusFocused. An optional displacement can be specified in the property CenterOffset.
property float TrackLeftRadiusActive = 0.0;
The property 'TrackLeftRadiusActive' specifies the radius of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The value is expressed in pixel. The thickness of the segment is determined in the property TrackLeftThicknessActive.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackLeftMarginEnd, TrackLeftMarginStart, TrackLeftRoundedEnd and TrackLeftRoundedStart.
property float TrackLeftRadiusDefault = 0.0;
The property 'TrackLeftRadiusDefault' specifies the radius of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'default' state. The value is expressed in pixel. The thickness of the segment is determined in the property TrackLeftThicknessDefault.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackLeftMarginEnd, TrackLeftMarginStart, TrackLeftRoundedEnd and TrackLeftRoundedStart.
property float TrackLeftRadiusDisabled = 0.0;
The property 'TrackLeftRadiusDisabled' specifies the radius of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. The thickness of the segment is determined in the property TrackLeftThicknessDisabled.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackLeftMarginEnd, TrackLeftMarginStart, TrackLeftRoundedEnd and TrackLeftRoundedStart.
property float TrackLeftRadiusFocused = 0.0;
The property 'TrackLeftRadiusFocused' specifies the radius of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'focused' state (the widget can react to keyboard events). The value is expressed in pixel. The thickness of the segment is determined in the property TrackLeftThicknessFocused.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackLeftMarginEnd, TrackLeftMarginStart, TrackLeftRoundedEnd and TrackLeftRoundedStart.
property bool TrackLeftRoundedEnd = false;
The property 'TrackLeftRoundedEnd' determines the appearance at the end of the left track (corresponding to the actual thumb position). If this property is 'true', the cap at the track end is rounded otherwise it is flat. See also TrackLeftMarginEnd, TrackLeftRadiusDefault, TrackLeftRadiusDisabled, TrackLeftRadiusFocused, TrackLeftRadiusActive, TrackLeftThicknessDefault, TrackLeftThicknessDisabled, TrackLeftThicknessFocused, TrackLeftThicknessActive, TrackLeftRoundedStart.
property bool TrackLeftRoundedStart = false;
The property 'TrackLeftRoundedStart' determines the appearance at the beginning of the left track (corresponding to the leftmost rotation position (clockwise) of the thumb). If this property is 'true', the cap at the track begin is rounded otherwise it is flat. See also TrackLeftMarginStart, TrackLeftRadiusDefault, TrackLeftRadiusDisabled, TrackLeftRadiusFocused, TrackLeftRadiusActive, TrackLeftThicknessDefault, TrackLeftThicknessDisabled, TrackLeftThicknessFocused, TrackLeftThicknessActive, TrackLeftRoundedEnd.
property int32 TrackLeftStackingPriority = 3;
The property 'TrackLeftStackingPriority' determines the Z-order position of the views destined to display the left track (filled arc and border surrounding it). Per default all left track views are arranged in front of the scale and right track views. By configuring this property the arrangement of the views within the widget can be changed whereby views with larger priority will be arranged in front of views with lower priority. For example, to place the left track views behind the right track, configure the property with a smaller value.
property bool TrackLeftStatic = false;
The property 'TrackLeftStatic' controls the size calculation of the area destined to display views belonging to the left track (filled arc and border surrounding it). If this property is 'false', the left track ends automatically at the actual position of the thumb. When the thumb is moved, the length of the track is adjusted accordingly.
By initializing this property with the value 'true', the track assumes its maximum possible length determined in the property TrackLeftMarginEnd. Now, the length of the track does not correspond anymore to the position of the thumb. The track has a static length.
property float TrackLeftThicknessActive = 0.0;
The property 'TrackLeftThicknessActive' specifies the thickness of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The radius of the segment is determined in the property TrackLeftRadiusActive.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackLeftMarginEnd, TrackLeftMarginStart, TrackLeftRoundedEnd and TrackLeftRoundedStart.
property float TrackLeftThicknessDefault = 0.0;
The property 'TrackLeftThicknessDefault' specifies the thickness of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'default' state. The radius of the segment is determined in the property TrackLeftRadiusDefault.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackLeftMarginEnd, TrackLeftMarginStart, TrackLeftRoundedEnd and TrackLeftRoundedStart.
property float TrackLeftThicknessDisabled = 0.0;
The property 'TrackLeftThicknessDisabled' specifies the thickness of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. The radius of the segment is determined in the property TrackLeftRadiusDisabled.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackLeftMarginEnd, TrackLeftMarginStart, TrackLeftRoundedEnd and TrackLeftRoundedStart.
property float TrackLeftThicknessFocused = 0.0;
The property 'TrackLeftThicknessFocused' specifies the thickness of the circle segment displayed usually on the left (clockwise) of the actual thumb position when the widget is in the 'focused' state (the widget can react to keyboard events). The radius of the segment is determined in the property TrackLeftRadiusFocused.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackLeftMarginEnd, TrackLeftMarginStart, TrackLeftRoundedEnd and TrackLeftRoundedStart.
property color TrackRightBorderColorActive = #00000000;
The property 'TrackRightBorderColorActive' determines the color of the border surrounding the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). To determine the thickness of the border use the property TrackRightBorderWidthActive. See also TrackRightRadiusActive, TrackRightThicknessActive, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property color TrackRightBorderColorDefault = #00000000;
The property 'TrackRightBorderColorDefault' determines the color of the border surrounding the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'default' state. To determine the thickness of the border use the property TrackRightBorderWidthDefault. See also TrackRightRadiusDefault, TrackRightThicknessDefault, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property color TrackRightBorderColorDisabled = #00000000;
The property 'TrackRightBorderColorDisabled' determines the color of the border surrounding the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). To determine the thickness of the border use the property TrackRightBorderWidthDisabled. See also TrackRightRadiusDisabled, TrackRightThicknessDisabled, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property color TrackRightBorderColorFocused = #00000000;
The property 'TrackRightBorderColorFocused' determines the color of the border surrounding the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'focused' state (the widget can react to keyboard events). To determine the thickness of the border use the property TrackRightBorderWidthFocused. See also TrackRightRadiusFocused, TrackRightThicknessFocused, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property float TrackRightBorderWidthActive = 0.0;
The property 'TrackRightBorderWidthActive' determines the thickness of the border surrounding the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The value is expressed in pixel. To determine the color of the border use the property TrackRightBorderColorActive. See also TrackRightRadiusActive, TrackRightThicknessActive, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property float TrackRightBorderWidthDefault = 0.0;
The property 'TrackRightBorderWidthDefault' determines the thickness of the border surrounding the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'default' state. The value is expressed in pixel. To determine the color of the border use the property TrackRightBorderColorDefault. See also TrackRightRadiusDefault, TrackRightThicknessDefault, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property float TrackRightBorderWidthDisabled = 0.0;
The property 'TrackRightBorderWidthDisabled' determines the thickness of the border surrounding the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. To determine the color of the border use the property TrackRightBorderColorDisabled. See also TrackRightRadiusDisabled, TrackRightThicknessDisabled, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property float TrackRightBorderWidthFocused = 0.0;
The property 'TrackRightBorderWidthFocused' determines the thickness of the border surrounding the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'focused' state (the widget can react to keyboard events). The value is expressed in pixel. To determine the color of the border use the property TrackRightBorderColorFocused. See also TrackRightRadiusFocused, TrackRightThicknessFocused, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property color TrackRightColorActive = #FFFFFFFF;
The property 'TrackRightColorActive' determines the color of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). See also TrackRightRadiusActive, TrackRightThicknessActive, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property color TrackRightColorDefault = #FFFFFFFF;
The property 'TrackRightColorDefault' determines the color of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'default' state. See also TrackRightRadiusDefault, TrackRightThicknessDefault, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property color TrackRightColorDisabled = #FFFFFFFF;
The property 'TrackRightColorDisabled' determines the color of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). See also TrackRightRadiusDisabled, TrackRightThicknessDisabled, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property color TrackRightColorFocused = #FFFFFFFF;
The property 'TrackRightColorFocused' determines the color of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'focused' state (the widget can react to keyboard events). See also TrackRightRadiusFocused, TrackRightThicknessFocused, TrackRightRoundedEnd, TrackRightRoundedStart, TrackRightMarginEnd and TrackRightMarginStart.
property float TrackRightMarginEnd = 0.0;
The property 'TrackRightMarginEnd' adjusts the end position of the right track relative to the end of the thumb movement range. The movement range is determined by the properties ThumbMinAngle and ThumbMaxAngle. Configuring this property with a negative value causes the track to end beyond (outside) the thumb movement range. The margin is expressed in degree.
The right track (composed of a filled arc and border surrounding it) is arranged relative to the center position of the rotary knob widget with radius configured in the properties TrackRightRadiusActive, TrackRightRadiusDefault, TrackRightRadiusDisabled, TrackRightRadiusFocused. An optional displacement can be specified in the property CenterOffset.
property float TrackRightMarginStart = 0.0;
The property 'TrackRightMarginStart' adjusts the start position of the right track relative to the start of the thumb movement range. The movement range is determined by the properties ThumbMinAngle and ThumbMaxAngle. Configuring this property with a negative value causes the track to start beyond (outside) the thumb movement range. The margin is expressed in degree.
Usually the start of the right track corresponds to the actual thumb position. When the thumb is moved, the length of the track is adjusted accordingly. By using this property, the tracks's start position can be limited to not exceed the predetermined angle. To adjust the end position of the track, use the property TrackRightMarginEnd.
The right track (composed of a filled arc and border surrounding it) is arranged relative to the center position of the rotary knob widget with radius configured in the properties TrackRightRadiusActive, TrackRightRadiusDefault, TrackRightRadiusDisabled, TrackRightRadiusFocused. An optional displacement can be specified in the property CenterOffset. With the property TrackRightStatic the right track can be configured to not depend on the actual thumb position.
property float TrackRightRadiusActive = 0.0;
The property 'TrackRightRadiusActive' specifies the radius of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The value is expressed in pixel. The thickness of the segment is determined in the property TrackRightThicknessActive.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackRightMarginEnd, TrackRightMarginStart, TrackRightRoundedEnd and TrackRightRoundedStart.
property float TrackRightRadiusDefault = 0.0;
The property 'TrackRightRadiusDefault' specifies the radius of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'default' state. The value is expressed in pixel. The thickness of the segment is determined in the property TrackRightThicknessDefault.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackRightMarginEnd, TrackRightMarginStart, TrackRightRoundedEnd and TrackRightRoundedStart.
property float TrackRightRadiusDisabled = 0.0;
The property 'TrackRightRadiusDisabled' specifies the radius of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. The thickness of the segment is determined in the property TrackRightThicknessDisabled.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackRightMarginEnd, TrackRightMarginStart, TrackRightRoundedEnd and TrackRightRoundedStart.
property float TrackRightRadiusFocused = 0.0;
The property 'TrackRightRadiusFocused' specifies the radius of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'focused' state (the widget can react to keyboard events). The value is expressed in pixel. The thickness of the segment is determined in the property TrackRightThicknessFocused.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackRightMarginEnd, TrackRightMarginStart, TrackRightRoundedEnd and TrackRightRoundedStart.
property bool TrackRightRoundedEnd = false;
The property 'TrackRightRoundedEnd' determines the appearance at the end of the right track (corresponding to the rightmost rotation position (clockwise) of the thumb). If this property is 'true', the cap at the track end is rounded otherwise it is flat. See also TrackRightMarginEnd, TrackRightRadiusDefault, TrackRightRadiusDisabled, TrackRightRadiusFocused, TrackRightRadiusActive, TrackRightThicknessDefault, TrackRightThicknessDisabled, TrackRightThicknessFocused, TrackRightThicknessActive, TrackRightRoundedStart.
property bool TrackRightRoundedStart = false;
The property 'TrackRightRoundedStart' determines the appearance at the start of the right track (corresponding to the actual thumb position). If this property is 'true', the cap at the track start is rounded otherwise it is flat. See also TrackRightMarginStart, TrackRightRadiusDefault, TrackRightRadiusDisabled, TrackRightRadiusFocused, TrackRightRadiusActive, TrackRightThicknessDefault, TrackRightThicknessDisabled, TrackRightThicknessFocused, TrackRightThicknessActive, TrackRightRoundedEnd.
property int32 TrackRightStackingPriority = 2;
The property 'TrackRightStackingPriority' determines the Z-order position of the views destined to display the right track (filled arc and border surrounding it). Per default all right track views are arranged in front of the scale view just behind the left track. By configuring this property the arrangement of the views within the widget can be changed whereby views with larger priority will be arranged in front of views with lower priority. For example, to place the right track views in front of the left track, configure the property with a larger value.
property bool TrackRightStatic = false;
The property 'TrackRightStatic' controls the size calculation of the area destined to display views belonging to the right track (filled arc and border surrounding it). If this property is 'false', the right track starts automatically at the actual position of the thumb. When the thumb is moved, the length of the track is adjusted accordingly.
By initializing this property with the value 'true', the track assumes its maximum possible length determined in the property TrackRightMarginStart. Now, the length of the track does not correspond anymore to the position of the thumb. The track has a static length.
property float TrackRightThicknessActive = 0.0;
The property 'TrackRightThicknessActive' specifies the thickness of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'active' state (the user is actually touching the rotary knob widget or pressing a key on the keyboard the widget should react on). The radius of the segment is determined in the property TrackRightRadiusActive.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackRightMarginEnd, TrackRightMarginStart, TrackRightRoundedEnd and TrackRightRoundedStart.
property float TrackRightThicknessDefault = 0.0;
The property 'TrackRightThicknessDefault' specifies the thickness of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'default' state. The radius of the segment is determined in the property TrackRightRadiusDefault.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackRightMarginEnd, TrackRightMarginStart, TrackRightRoundedEnd and TrackRightRoundedStart.
property float TrackRightThicknessDisabled = 0.0;
The property 'TrackRightThicknessDisabled' specifies the thickness of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'disabled' state (property 'Enabled' of the widget is 'false'). The value is expressed in pixel. The radius of the segment is determined in the property TrackRightRadiusDisabled.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackRightMarginEnd, TrackRightMarginStart, TrackRightRoundedEnd and TrackRightRoundedStart.
property float TrackRightThicknessFocused = 0.0;
The property 'TrackRightThicknessFocused' specifies the thickness of the circle segment displayed usually on the right (clockwise) of the actual thumb position when the widget is in the 'focused' state (the widget can react to keyboard events). The radius of the segment is determined in the property TrackRightRadiusFocused.
The center of the circle segment corresponds to the position around which the thumb is rotated (CenterOffset). See also TrackRightMarginEnd, TrackRightMarginStart, TrackRightRoundedEnd and TrackRightRoundedStart.
property point WidgetMaxSize = <0,0>;
The property 'WidgetMaxSize' determines the maximum allowed size of the widget. Accordingly, the rotary knob widget can't become bigger than the value specified in this property. By using this property you can configure the size constraints for the rotary knob widget.
property point WidgetMinSize = <0,0>;
The property 'WidgetMinSize' determines the minimal allowed size of the widget. Accordingly, the rotary knob widget can't become smaller than the value specified in this property. By using this property you can configure the size constraints for the rotary knob widget.
