Unit WidgetSet: WidgetSet::ToggleButtonConfig

Reference for the Mosaic class WidgetSet::ToggleButtonConfig

WidgetSet::ToggleButtonConfig

AccentLayout
AccentOffBorderColorActive
AccentOffBorderColorDefault
AccentOffBorderColorDisabled
AccentOffBorderColorFocused
AccentOffBorderWidthActive
AccentOffBorderWidthDefault
AccentOffBorderWidthDisabled
AccentOffBorderWidthFocused
AccentOffColorActive
AccentOffColorDefault
AccentOffColorDisabled
AccentOffColorFocused
AccentOffCornerRadiusActive
AccentOffCornerRadiusDefault
AccentOffCornerRadiusDisabled
AccentOffCornerRadiusFocused
AccentOffOffsetActive
AccentOffOffsetDefault
AccentOffOffsetDisabled
AccentOffOffsetFocused
AccentOffSizeActive
AccentOffSizeDefault
AccentOffSizeDisabled
AccentOffSizeFocused
AccentOnBorderColorActive
AccentOnBorderColorDefault
AccentOnBorderColorDisabled
AccentOnBorderColorFocused
AccentOnBorderWidthActive
AccentOnBorderWidthDefault
AccentOnBorderWidthDisabled
AccentOnBorderWidthFocused
AccentOnColorActive
AccentOnColorDefault
AccentOnColorDisabled
AccentOnColorFocused
AccentOnCornerRadiusActive
AccentOnCornerRadiusDefault
AccentOnCornerRadiusDisabled
AccentOnCornerRadiusFocused
AccentOnOffsetActive
AccentOnOffsetDefault
AccentOnOffsetDisabled
AccentOnOffsetFocused
AccentOnSizeActive
AccentOnSizeDefault
AccentOnSizeDisabled
AccentOnSizeFocused
AccentStackingPriority
CommonOffOffsetActive
CommonOffOffsetDefault
CommonOffOffsetDisabled
CommonOffOffsetFocused
CommonOnOffsetActive
CommonOnOffsetDefault
CommonOnOffsetDisabled
CommonOnOffsetFocused
FaceLayout
FaceMarginBottom
FaceMarginLeft
FaceMarginRight
FaceMarginTop
FaceOffBitmapActive
FaceOffBitmapDefault
FaceOffBitmapDisabled
FaceOffBitmapFocused
FaceOffFrameActive
FaceOffFrameDefault
FaceOffFrameDisabled
FaceOffFrameFocused
FaceOffTintActive
FaceOffTintDefault
FaceOffTintDisabled
FaceOffTintFocused
FaceOnBitmapActive
FaceOnBitmapDefault
FaceOnBitmapDisabled
FaceOnBitmapFocused
FaceOnFrameActive
FaceOnFrameDefault
FaceOnFrameDisabled
FaceOnFrameFocused
FaceOnTintActive
FaceOnTintDefault
FaceOnTintDisabled
FaceOnTintFocused
FaceStackingPriority
IconAlignment
IconMarginBottom
IconMarginLeft
IconMarginRight
IconMarginTop
IconOffTintActive
IconOffTintDefault
IconOffTintDisabled
IconOffTintFocused
IconOnTintActive
IconOnTintDefault
IconOnTintDisabled
IconOnTintFocused
IconStackingPriority
KeyCode
LabelAlignment
LabelMarginBottom
LabelMarginLeft
LabelMarginRight
LabelMarginTop
LabelOffColorActive
LabelOffColorDefault
LabelOffColorDisabled
LabelOffColorFocused
LabelOffFont
LabelOnColorActive
LabelOnColorDefault
LabelOnColorDisabled
LabelOnColorFocused
LabelOnFont
LabelStackingPriority
LimitTouchArea
OnUpdate
PressedFeedbackDuration
StateTransitionDuration
ThumbLayout
ThumbOffBorderColorActive
ThumbOffBorderColorDefault
ThumbOffBorderColorDisabled
ThumbOffBorderColorFocused
ThumbOffBorderWidthActive
ThumbOffBorderWidthDefault
ThumbOffBorderWidthDisabled
ThumbOffBorderWidthFocused
ThumbOffColorActive
ThumbOffColorDefault
ThumbOffColorDisabled
ThumbOffColorFocused
ThumbOffCornerRadiusActive
ThumbOffCornerRadiusDefault
ThumbOffCornerRadiusDisabled
ThumbOffCornerRadiusFocused
ThumbOffOffsetActive
ThumbOffOffsetDefault
ThumbOffOffsetDisabled
ThumbOffOffsetFocused
ThumbOffShadowBlurRadiusActive
ThumbOffShadowBlurRadiusDefault
ThumbOffShadowBlurRadiusDisabled
ThumbOffShadowBlurRadiusFocused
ThumbOffShadowColorActive
ThumbOffShadowColorDefault
ThumbOffShadowColorDisabled
ThumbOffShadowColorFocused
ThumbOffShadowOffsetActive
ThumbOffShadowOffsetDefault
ThumbOffShadowOffsetDisabled
ThumbOffShadowOffsetFocused
ThumbOffSizeActive
ThumbOffSizeDefault
ThumbOffSizeDisabled
ThumbOffSizeFocused
ThumbOnBorderColorActive
ThumbOnBorderColorDefault
ThumbOnBorderColorDisabled
ThumbOnBorderColorFocused
ThumbOnBorderWidthActive
ThumbOnBorderWidthDefault
ThumbOnBorderWidthDisabled
ThumbOnBorderWidthFocused
ThumbOnColorActive
ThumbOnColorDefault
ThumbOnColorDisabled
ThumbOnColorFocused
ThumbOnCornerRadiusActive
ThumbOnCornerRadiusDefault
ThumbOnCornerRadiusDisabled
ThumbOnCornerRadiusFocused
ThumbOnOffsetActive
ThumbOnOffsetDefault
ThumbOnOffsetDisabled
ThumbOnOffsetFocused
ThumbOnShadowBlurRadiusActive
ThumbOnShadowBlurRadiusDefault
ThumbOnShadowBlurRadiusDisabled
ThumbOnShadowBlurRadiusFocused
ThumbOnShadowColorActive
ThumbOnShadowColorDefault
ThumbOnShadowColorDisabled
ThumbOnShadowColorFocused
ThumbOnShadowOffsetActive
ThumbOnShadowOffsetDefault
ThumbOnShadowOffsetDisabled
ThumbOnShadowOffsetFocused
ThumbOnSizeActive
ThumbOnSizeDefault
ThumbOnSizeDisabled
ThumbOnSizeFocused
ThumbStackingPriority
TrackCornerRadius
TrackLayout
TrackOffBorderColorActive
TrackOffBorderColorDefault
TrackOffBorderColorDisabled
TrackOffBorderColorFocused
TrackOffBorderWidthActive
TrackOffBorderWidthDefault
TrackOffBorderWidthDisabled
TrackOffBorderWidthFocused
TrackOffColorActive
TrackOffColorDefault
TrackOffColorDisabled
TrackOffColorFocused
TrackOffset
TrackOnBorderColorActive
TrackOnBorderColorDefault
TrackOnBorderColorDisabled
TrackOnBorderColorFocused
TrackOnBorderWidthActive
TrackOnBorderWidthDefault
TrackOnBorderWidthDisabled
TrackOnBorderWidthFocused
TrackOnColorActive
TrackOnColorDefault
TrackOnColorDisabled
TrackOnColorFocused
TrackSize
TrackStackingPriority
WidgetMaxSize
WidgetMinSize

WidgetSet::WidgetConfig

This class implements the functionality permitting you to simply customize the look and feel of a bistable 'toggle button' widget (WidgetSet::ToggleButton). 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 toggle button widget. Thereupon the widgets will use the configuration information provided in the object.

During its lifetime the button remains always in one of the four states: 'disabled', 'default', 'focused' and 'active'. The state 'disabled' is true for every not available button (the property 'Enabled' of the button is 'false'). Such buttons will ignore all user inputs. The state 'default' determines a button, which is ready to be touched by the user or ready to become focused. As soon as the button becomes focused, it switches in the state 'focused'. In this state the user can activate the button by pressing a key on the keyboard. Finally, the state 'active' is true, if the user actually interacts with the button (the button is pressed). At the same time, the toggle button distinguishes between two further states: 'on' (checked) and 'off' (unchecked). With the configuration object you can specify the appearance of the button for every state combination individually. For this purpose you should know from which views the button is composed of:

'FaceImage' is a bitmap frame view (Views::Frame) filling per default the entire background of the button unless the area is reduced by using the properties FaceMarginBottom, FaceMarginLeft, FaceMarginRight, FaceMarginTop. The position can additionally be adjusted for each state individually (CommonOffOffsetActive, CommonOffOffsetDefault, CommonOffOffsetDisabled, CommonOffOffsetFocused, CommonOnOffsetActive, CommonOnOffsetDefault, CommonOnOffsetDisabled, CommonOnOffsetFocused). In the configuration object you can individually specify for every button state combination the desired bitmap (FaceOffBitmapActive, FaceOffBitmapDefault, FaceOffBitmapDisabled, FaceOffBitmapFocused, FaceOnBitmapActive, FaceOnBitmapDefault, FaceOnBitmapDisabled, FaceOnBitmapFocused), the frame number within the bitmap (FaceOffFrameActive, FaceOffFrameDefault, FaceOffFrameDisabled, FaceOffFrameFocused, FaceOnFrameActive, FaceOnFrameDefault, FaceOnFrameDisabled, FaceOnFrameFocused) and opacity or color to tint the bitmap (FaceOffTintActive, FaceOffTintDefault, FaceOffTintDisabled, FaceOffTintFocused, FaceOnTintActive, FaceOnTintDefault, FaceOnTintDisabled, FaceOnTintFocused). The button can automatically play animated bitmaps if the corresponding frame number is -1. If desired, with the property FaceLayout you can also configure the bitmap to be arranged horizontally and vertically instead of filling the entire widget area.
'ThumbRectangle' is a rectangle view (Views::Rectangle) filling per default the entire area of the button unless other constraints (ThumbLayout), a size alternation (ThumbOffSizeActive, ThumbOffSizeDefault, ThumbOffSizeDisabled, ThumbOffSizeFocused, ThumbOnSizeActive, ThumbOnSizeDefault, ThumbOnSizeDisabled, ThumbOnSizeFocused) or a displacement (ThumbOffOffsetActive, ThumbOffOffsetDefault, ThumbOffOffsetDisabled, ThumbOffOffsetFocused, ThumbOnOffsetActive, ThumbOnOffsetDefault, ThumbOnOffsetDisabled, ThumbOnOffsetFocused) have been specified. Normally, the thumb has rectangular shape with sharp corners. If desired the corners can be rounded (ThumbOffCornerRadiusActive, ThumbOffCornerRadiusDefault, ThumbOffCornerRadiusDisabled, ThumbOffCornerRadiusFocused, ThumbOnCornerRadiusActive, ThumbOnCornerRadiusDefault, ThumbOnCornerRadiusDisabled, ThumbOnCornerRadiusFocused). The thumb can be filled with a solid color (ThumbOffColorActive, ThumbOffColorDefault, ThumbOffColorDisabled, ThumbOffColorFocused, ThumbOnColorActive, ThumbOnColorDefault, ThumbOnColorDisabled, ThumbOnColorFocused).
'ThumbBorder' is a border view (Views::Border) surrounding the above described 'ThumbRectangle' and lying in front of it. Its size, position and corner radius correspond thus to the of the 'ThumbRectangle'. The thickness of the border (ThumbOffBorderWidthActive, ThumbOffBorderWidthDefault, ThumbOffBorderWidthDisabled, ThumbOffBorderWidthFocused, ThumbOnBorderWidthActive, ThumbOnBorderWidthDefault, ThumbOnBorderWidthDisabled, ThumbOnBorderWidthFocused) and its color (ThumbOffBorderColorActive, ThumbOffBorderColorDefault, ThumbOffBorderColorDisabled, ThumbOffBorderColorFocused, ThumbOnBorderColorActive, ThumbOnBorderColorDefault, ThumbOnBorderColorDisabled, ThumbOnBorderColorFocused) can be specified.
'ThumbShadow' is a shadow view (Views::Shadow) lying always behind the above described 'ThumbRectangle' view. Its size, position and corner radius correspond thus to the of the 'ThumbRectangle'. However, an additional displacement for the shadow can be specified (ThumbOffShadowOffsetActive, ThumbOffShadowOffsetDefault, ThumbOffShadowOffsetDisabled, ThumbOffShadowOffsetFocused, ThumbOnShadowOffsetActive, ThumbOnShadowOffsetDefault, ThumbOnShadowOffsetDisabled, ThumbOnShadowOffsetFocused). The color of the shadow (ThumbOffShadowColorActive, ThumbOffShadowColorDefault, ThumbOffShadowColorDisabled, ThumbOffShadowColorFocused, ThumbOnShadowColorActive, ThumbOnShadowColorDefault, ThumbOnShadowColorDisabled, ThumbOnShadowColorFocused) as well as its blur radius (ThumbOffShadowBlurRadiusActive, ThumbOffShadowBlurRadiusDefault, ThumbOffShadowBlurRadiusDisabled, ThumbOffShadowBlurRadiusFocused, ThumbOnShadowBlurRadiusActive, ThumbOnShadowBlurRadiusDefault, ThumbOnShadowBlurRadiusDisabled, ThumbOnShadowBlurRadiusFocused) can be specified.
'TrackRectangle' is a rectangle view (Views::Rectangle) filling per default the entire area of the button unless other constraints (TrackLayout), a size alternation (TrackSize) or a displacement (TrackOffset) have been specified. Normally, the track has rectangular shape with sharp corners. If desired the corners can be rounded (TrackCornerRadius). The track can be filled with a solid color (TrackOffColorActive, TrackOffColorDefault, TrackOffColorDisabled, TrackOffColorFocused, TrackOnColorActive, TrackOnColorDefault, TrackOnColorDisabled, TrackOnColorFocused). Track usually serves to visualize the area where thumb is moved and it is usually arranged behind the thumb.
'TrackBorder' is a border view (Views::Border) surrounding the above described 'TrackRectangle' and lying in front of it. Its size, position and corner radius correspond thus to the of the 'TrackRectangle'. The thickness of the border (TrackOffBorderWidthActive, TrackOffBorderWidthDefault, TrackOffBorderWidthDisabled, TrackOffBorderWidthFocused, TrackOnBorderWidthActive, TrackOnBorderWidthDefault, TrackOnBorderWidthDisabled, TrackOnBorderWidthFocused) and its color (TrackOffBorderColorActive, TrackOffBorderColorDefault, TrackOffBorderColorDisabled, TrackOffBorderColorFocused, TrackOnBorderColorActive, TrackOnBorderColorDefault, TrackOnBorderColorDisabled, TrackOnBorderColorFocused) can be specified. Track usually serves to visualize the area where thumb is moved and it is usually arranged behind the thumb.
'AccentRectangle' is a rectangle view (Views::Rectangle) filling per default the entire area of the button unless other constraints (AccentLayout), a size alternation (AccentOffSizeActive, AccentOffSizeDefault, AccentOffSizeDisabled, AccentOffSizeFocused, AccentOnSizeActive, AccentOnSizeDefault, AccentOnSizeDisabled, AccentOnSizeFocused) or a displacement (AccentOffOffsetActive, AccentOffOffsetDefault, AccentOffOffsetDisabled, AccentOffOffsetFocused, AccentOnOffsetActive, AccentOnOffsetDefault, AccentOnOffsetDisabled, AccentOnOffsetFocused) have been specified. Normally, the accent area has rectangular shape with sharp corners. If desired the corners can be rounded (AccentOffCornerRadiusActive, AccentOffCornerRadiusDefault, AccentOffCornerRadiusDisabled, AccentOffCornerRadiusFocused, AccentOnCornerRadiusActive, AccentOnCornerRadiusDefault, AccentOnCornerRadiusDisabled, AccentOnCornerRadiusFocused). The accent area can be filled with a solid color (AccentOffColorActive, AccentOffColorDefault, AccentOffColorDisabled, AccentOffColorFocused, AccentOnColorActive, AccentOnColorDefault, AccentOnColorDisabled, AccentOnColorFocused). Accent usually serves to highlight the widget when the user interacts with it actively or when the widget is focused.
'AccentBorder' is a border view (Views::Border) surrounding the above described 'AccentRectangle' and lying in front of it. Its size, position and corner radius correspond thus to the of the 'AccentRectangle'. The thickness of the border (AccentOffBorderWidthActive, AccentOffBorderWidthDefault, AccentOffBorderWidthDisabled, AccentOffBorderWidthFocused, AccentOnBorderWidthActive, AccentOnBorderWidthDefault, AccentOnBorderWidthDisabled, AccentOnBorderWidthFocused) and its color (AccentOffBorderColorActive, AccentOffBorderColorDefault, AccentOffBorderColorDisabled, AccentOffBorderColorFocused, AccentOnBorderColorActive, AccentOnBorderColorDefault, AccentOnBorderColorDisabled, AccentOnBorderColorFocused) can be specified. Accent usually serves to highlight the widget when the user interacts with it actively or when the widget is focused.
'Icon' is an image view (Views::Image) displayed per default in the center of the button. The corresponding bitmap is determined in the property 'Icon' in the toggle button widget. In the configuration object you can specify the alignment (IconAlignment) and margins (IconMarginBottom, IconMarginLeft, IconMarginRight, IconMarginTop) how to arrange the 'Icon' bitmap within the button area. The position can additionally be adjusted for each state individually (CommonOffOffsetActive, CommonOffOffsetDefault, CommonOffOffsetDisabled, CommonOffOffsetFocused, CommonOnOffsetActive, CommonOnOffsetDefault, CommonOnOffsetDisabled, CommonOnOffsetFocused). Furthermore, for every button state combination the opacity or color to tint the bitmap can be determined (IconOffTintActive, IconOffTintDefault, IconOffTintDisabled, IconOffTintFocused, IconOnTintActive, IconOnTintDefault, IconOnTintDisabled, IconOnTintFocused).
'Label' is a text view (Views::Text) displayed per default in the center of the button. The corresponding text is determined in the property 'LabelOff' or 'LabelOn' in the toggle button widget. In the configuration object you can specify the font (LabelOffFont, LabelOnFont), alignment (LabelAlignment) and margins (LabelMarginBottom, LabelMarginLeft, LabelMarginRight, LabelMarginTop) to use for the text view. The position can additionally be adjusted for each state individually (CommonOffOffsetActive, CommonOffOffsetDefault, CommonOffOffsetDisabled, CommonOffOffsetFocused, CommonOnOffsetActive, CommonOnOffsetDefault, CommonOnOffsetDisabled, CommonOnOffsetFocused). For every button state combination you can specify individual text color values (LabelOffColorActive, LabelOffColorDefault, LabelOffColorDisabled, LabelOffColorFocused, LabelOnColorActive, LabelOnColorDefault, LabelOnColorDisabled, LabelOnColorFocused).

All above mentioned views are arranged one above the other whereby the resulting stacking order can be configured by using the properties FaceStackingPriority, IconStackingPriority, LabelStackingPriority, ThumbStackingPriority, TrackStackingPriority and AccentStackingPriority. 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 toggle button to perform state alternations with animations (e.g. the displacement of the shadow can be animated). This affects all attributes of the views 'ThumbRectangle', 'ThumbBorder', 'ThumbShadow', 'TrackRectangle' and 'TrackBorder'. In case of the views 'FaceImage', 'Label' and 'Icon' 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 button is actually focused, it can also be activated by pressing the keyboard key specified in the property KeyCode. To prevent the button from being able to be focused, initialize this property with the value Core::KeyCode.NoKey. The property PressedFeedbackDuration configures the duration how long the button should appear active (pressed) even if it has been taped for a very short time.

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 button to not shrink below a specified width or height.

property Core::Layout AccentLayout = Core::Layout[AlignToBottom, AlignToLeft, AlignToRight, AlignToTop, ResizeHorz, ResizeVert];

The property 'AccentLayout' determines the constraints how the accent area (composed of a rectangle and border) should be aligned within the button area. Per default the accent area fills the button widget entirely.

The constraints 'ResizeVert' and 'ResizeHorz' determine whether the accent area should be resized to fill the button vertically and/or horizontally. Deactivating the constraint causes the button to display the accent area with fixed height and/or width determined by the property AccentOffSizeActive, AccentOffSizeDefault, AccentOffSizeDisabled, AccentOffSizeFocused, AccentOnSizeActive, AccentOnSizeDefault, AccentOnSizeDisabled or AccentOnSizeFocused depending on the actual state of the button. With the constraints 'AlignToTop', 'AlignToBottom', 'AlignToLeft' and 'AlignToRight' the accent area can be aligned within the button area.

Please note, by using the properties AccentOffOffsetActive, AccentOffOffsetDefault, AccentOffOffsetDisabled, AccentOffOffsetFocused, AccentOnOffsetActive, AccentOnOffsetDefault, AccentOnOffsetDisabled and AccentOnOffsetFocused an additional displacement for the accent area can be determined individually for each button state.

property color AccentOffBorderColorActive = #00000000;

The property 'AccentOffBorderColorActive' determines the color to stroke the border surrounding the accent area when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). To determine the thickness of the border use the property AccentOffBorderWidthActive.

property color AccentOffBorderColorDefault = #00000000;

The property 'AccentOffBorderColorDefault' determines the color to stroke the border surrounding the accent area when the button is switched-off and it is in the 'default' state. To determine the thickness of the border use the property AccentOffBorderWidthDefault.

property color AccentOffBorderColorDisabled = #00000000;

The property 'AccentOffBorderColorDisabled' determines the color to stroke the border surrounding the accent area when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). To determine the thickness of the border use the property AccentOffBorderWidthDisabled.

property color AccentOffBorderColorFocused = #00000000;

The property 'AccentOffBorderColorFocused' determines the color to stroke the border surrounding the accent area when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). To determine the thickness of the border use the property AccentOffBorderWidthFocused.

property int32 AccentOffBorderWidthActive = 0;

The property 'AccentOffBorderWidthActive' determines the thickness of the border surrounding the accent area when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). To determine the color of the border use the property AccentOffBorderColorActive.

property int32 AccentOffBorderWidthDefault = 0;

The property 'AccentOffBorderWidthDefault' determines the thickness of the border surrounding the accent area when the button is switched-off and it is in the 'default' state. The value is expressed in pixel. To determine the color of the border use the property AccentOffBorderColorDefault.

property int32 AccentOffBorderWidthDisabled = 0;

The property 'AccentOffBorderWidthDisabled' determines the thickness of the border surrounding the accent area when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The value is expressed in pixel. To determine the color of the border use the property AccentOffBorderColorDisabled.

property int32 AccentOffBorderWidthFocused = 0;

The property 'AccentOffBorderWidthFocused' determines the thickness of the border surrounding the accent area when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). The value is expressed in pixel. To determine the color of the border use the property AccentOffBorderColorFocused.

property color AccentOffColorActive = #00000000;

The property 'AccentOffColorActive' determines the color to fill the background of the accent area when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on).

property color AccentOffColorDefault = #00000000;

The property 'AccentOffColorDefault' determines the color to fill the background of the accent area when the button is switched-off and it is in the 'default' state.

property color AccentOffColorDisabled = #00000000;

The property 'AccentOffColorDisabled' determines the color to fill the background of the accent area when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

property color AccentOffColorFocused = #00000000;

The property 'AccentOffColorFocused' determines the color to fill the background of the accent area when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events).

property int32 AccentOffCornerRadiusActive = 0;

The property 'AccentOffCornerRadiusActive' controls the rounding at corners of the accent area when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button 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 '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 accent area.

property int32 AccentOffCornerRadiusDefault = 0;

The property 'AccentOffCornerRadiusDefault' controls the rounding at corners of the accent area when the button is switched-off and it 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.

property int32 AccentOffCornerRadiusDisabled = 0;

The property 'AccentOffCornerRadiusDisabled' controls the rounding at corners of the accent area when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button 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 '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 accent area.

property int32 AccentOffCornerRadiusFocused = 0;

The property 'AccentOffCornerRadiusFocused' controls the rounding at corners of the accent area when the button is switched-off and it is in the 'focused' state (the button 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 '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 accent area.

property point AccentOffOffsetActive = <0,0>;

The property 'AccentOffOffsetActive' determines an additional displacement for the accent area when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). Unless other constraints have been specified in the property AccentLayout, the accent area is aligned at the top-left corner of the button area. The value specified in the property AccentOffOffsetActive is used to move the accent area accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentOffSizeActive. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOffOffsetDefault = <0,0>;

The property 'AccentOffOffsetDefault' determines an additional displacement for the accent area when the button is switched-off and it is in the 'default' state. Unless other constraints have been specified in the property AccentLayout, the accent area is aligned at the top-left corner of the button area. The value specified in the property AccentOffOffsetDefault is used to move the accent area accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentOffSizeDefault. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOffOffsetDisabled = <0,0>;

The property 'AccentOffOffsetDisabled' determines an additional displacement for the accent area when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). Unless other constraints have been specified in the property AccentLayout, the accent area is aligned at the top-left corner of the button area. The value specified in the property AccentOffOffsetDisabled is used to move the accent area accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentOffSizeDisabled. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOffOffsetFocused = <0,0>;

The property 'AccentOffOffsetFocused' determines an additional displacement for the accent area when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). Unless other constraints have been specified in the property AccentLayout, the accent area is aligned at the top-left corner of the button area. The value specified in the property AccentOffOffsetFocused is used to move the accent area accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentOffSizeFocused. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOffSizeActive = <0,0>;

The property 'AccentOffSizeActive' controls the size of the accent area when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). Unless other constraints have been specified in the property AccentLayout, the accent area fills the complete button area. With the value specified in the property AccentOffSizeActive it is possible to enlarge the accent area. By specifying negative values in this property, the accent area will shrink accordingly. If AccentLayout is configured to not automatically resize the accent area, the value specified in the property AccentOffSizeActive determines the final size of the accent area. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the accent area can be modified by using the associated property AccentOffOffsetActive. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOffSizeDefault = <0,0>;

The property 'AccentOffSizeDefault' controls the size of the accent area when the button is switched-off and it is in the 'default' state. Unless other constraints have been specified in the property AccentLayout, the accent area fills the complete button area. With the value specified in the property AccentOffSizeDefault it is possible to enlarge the accent area. By specifying negative values in this property, the accent area will shrink accordingly. If AccentLayout is configured to not automatically resize the accent area, the value specified in the property AccentOffSizeDefault determines the final size of the accent area. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the accent area can be modified by using the associated property AccentOffOffsetDefault. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOffSizeDisabled = <0,0>;

The property 'AccentOffSizeDisabled' controls the size of the accent area when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). Unless other constraints have been specified in the property AccentLayout, the accent area fills the complete button area. With the value specified in the property AccentOffSizeDisabled it is possible to enlarge the accent area. By specifying negative values in this property, the accent area will shrink accordingly. If AccentLayout is configured to not automatically resize the accent area, the value specified in the property AccentOffSizeDisabled determines the final size of the accent area. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the accent area can be modified by using the associated property AccentOffOffsetDisabled. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOffSizeFocused = <0,0>;

The property 'AccentOffSizeFocused' controls the size of the accent area when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). Unless other constraints have been specified in the property AccentLayout, the accent area fills the complete button area. With the value specified in the property AccentOffSizeFocused it is possible to enlarge the accent area. By specifying negative values in this property, the accent area will shrink accordingly. If AccentLayout is configured to not automatically resize the accent area, the value specified in the property AccentOffSizeFocused determines the final size of the accent area. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the accent area can be modified by using the associated property AccentOffOffsetFocused. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property color AccentOnBorderColorActive = #00000000;

The property 'AccentOnBorderColorActive' determines the color to stroke the border surrounding the accent area when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). To determine the thickness of the border use the property AccentOnBorderWidthActive.

property color AccentOnBorderColorDefault = #00000000;

The property 'AccentOnBorderColorDefault' determines the color to stroke the border surrounding the accent area when the button is switched-on and it is in the 'default' state. To determine the thickness of the border use the property AccentOnBorderWidthDefault.

property color AccentOnBorderColorDisabled = #00000000;

The property 'AccentOnBorderColorDisabled' determines the color to stroke the border surrounding the accent area when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). To determine the thickness of the border use the property AccentOnBorderWidthDisabled.

property color AccentOnBorderColorFocused = #00000000;

The property 'AccentOnBorderColorFocused' determines the color to stroke the border surrounding the accent area when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). To determine the thickness of the border use the property AccentOnBorderWidthFocused.

property int32 AccentOnBorderWidthActive = 0;

The property 'AccentOnBorderWidthActive' determines the thickness of the border surrounding the accent area when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). The value is expressed in pixel. To determine the color of the border use the property AccentOnBorderColorActive.

property int32 AccentOnBorderWidthDefault = 0;

The property 'AccentOnBorderWidthDefault' determines the thickness of the border surrounding the accent area when the button is switched-on and it is in the 'default' state. The value is expressed in pixel. To determine the color of the border use the property AccentOnBorderColorDefault.

property int32 AccentOnBorderWidthDisabled = 0;

The property 'AccentOnBorderWidthDisabled' determines the thickness of the border surrounding the accent area when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The value is expressed in pixel. To determine the color of the border use the property AccentOnBorderColorDisabled.

property int32 AccentOnBorderWidthFocused = 0;

The property 'AccentOnBorderWidthFocused' determines the thickness of the border surrounding the accent area when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). The value is expressed in pixel. To determine the color of the border use the property AccentOnBorderColorFocused.

property color AccentOnColorActive = #00000000;

The property 'AccentOnColorActive' determines the color to fill the background of the accent area when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on).

property color AccentOnColorDefault = #00000000;

The property 'AccentOnColorDefault' determines the color to fill the background of the accent area when the button is switched-on and it is in the 'default' state.

property color AccentOnColorDisabled = #00000000;

The property 'AccentOnColorDisabled' determines the color to fill the background of the accent area when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

property color AccentOnColorFocused = #00000000;

The property 'AccentOnColorFocused' determines the color to fill the background of the accent area when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events).

property int32 AccentOnCornerRadiusActive = 0;

The property 'AccentOnCornerRadiusActive' controls the rounding at corners of the accent area when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button 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 '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 accent area.

property int32 AccentOnCornerRadiusDefault = 0;

The property 'AccentOnCornerRadiusDefault' controls the rounding at corners of the accent area when the button is switched-on and it 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.

property int32 AccentOnCornerRadiusDisabled = 0;

The property 'AccentOnCornerRadiusDisabled' controls the rounding at corners of the accent area when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button 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 '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 accent area.

property int32 AccentOnCornerRadiusFocused = 0;

The property 'AccentOnCornerRadiusFocused' controls the rounding at corners of the accent area when the button is switched-on and it is in the 'focused' state (the button 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 '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 accent area.

property point AccentOnOffsetActive = <0,0>;

The property 'AccentOnOffsetActive' determines an additional displacement for the accent area when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). Unless other constraints have been specified in the property AccentLayout, the accent area is aligned at the top-left corner of the button area. The value specified in the property AccentOnOffsetActive is used to move the accent area accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentOnSizeActive. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOnOffsetDefault = <0,0>;

The property 'AccentOnOffsetDefault' determines an additional displacement for the accent area when the button is switched-on and it is in the 'default' state. Unless other constraints have been specified in the property AccentLayout, the accent area is aligned at the top-left corner of the button area. The value specified in the property AccentOnOffsetDefault is used to move the accent area accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentOnSizeDefault. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOnOffsetDisabled = <0,0>;

The property 'AccentOnOffsetDisabled' determines an additional displacement for the accent area when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). Unless other constraints have been specified in the property AccentLayout, the accent area is aligned at the top-left corner of the button area. The value specified in the property AccentOnOffsetDisabled is used to move the accent area accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentOnSizeDisabled. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOnOffsetFocused = <0,0>;

The property 'AccentOnOffsetFocused' determines an additional displacement for the accent area when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). Unless other constraints have been specified in the property AccentLayout, the accent area is aligned at the top-left corner of the button area. The value specified in the property AccentOnOffsetFocused is used to move the accent area accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the accent area can be modified by using the associated property AccentOnSizeFocused. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOnSizeActive = <0,0>;

The property 'AccentOnSizeActive' controls the size of the accent area when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). Unless other constraints have been specified in the property AccentLayout, the accent area fills the complete button area. With the value specified in the property AccentOnSizeActive it is possible to enlarge the accent area. By specifying negative values in this property, the accent area will shrink accordingly. If AccentLayout is configured to not automatically resize the accent area, the value specified in the property AccentOnSizeActive determines the final size of the accent area. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the accent area can be modified by using the associated property AccentOnOffsetActive. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOnSizeDefault = <0,0>;

The property 'AccentOnSizeDefault' controls the size of the accent area when the button is switched-on and it is in the 'default' state. Unless other constraints have been specified in the property AccentLayout, the accent area fills the complete button area. With the value specified in the property AccentOnSizeDefault it is possible to enlarge the accent area. By specifying negative values in this property, the accent area will shrink accordingly. If AccentLayout is configured to not automatically resize the accent area, the value specified in the property AccentOnSizeDefault determines the final size of the accent area. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the accent area can be modified by using the associated property AccentOnOffsetDefault. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOnSizeDisabled = <0,0>;

The property 'AccentOnSizeDisabled' controls the size of the accent area when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). Unless other constraints have been specified in the property AccentLayout, the accent area fills the complete button area. With the value specified in the property AccentOnSizeDisabled it is possible to enlarge the accent area. By specifying negative values in this property, the accent area will shrink accordingly. If AccentLayout is configured to not automatically resize the accent area, the value specified in the property AccentOnSizeDisabled determines the final size of the accent area. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the accent area can be modified by using the associated property AccentOnOffsetDisabled. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property point AccentOnSizeFocused = <0,0>;

The property 'AccentOnSizeFocused' controls the size of the accent area when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). Unless other constraints have been specified in the property AccentLayout, the accent area fills the complete button area. With the value specified in the property AccentOnSizeFocused it is possible to enlarge the accent area. By specifying negative values in this property, the accent area will shrink accordingly. If AccentLayout is configured to not automatically resize the accent area, the value specified in the property AccentOnSizeFocused determines the final size of the accent area. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the accent area can be modified by using the associated property AccentOnOffsetFocused. In this manner the button can be configured with a accent area changing its position and size depending on the state of the widget.

property int32 AccentStackingPriority = 6;

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 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 place the accent views in background of the toggle button, configure the property with a smaller value.

property point CommonOffOffsetActive = <0,0>;

The property 'CommonOffOffsetActive' determines an additional displacement for areas destined to display the label text, the icon bitmap and the face bitmap when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). In this manner the label, icon and face can move depending on the state of the widget.

property point CommonOffOffsetDefault = <0,0>;

The property 'CommonOffOffsetDefault' determines an additional displacement for areas destined to display the label text, the icon bitmap and the face bitmap when the button is switched-off and it is in the 'default' state. In this manner the label, icon and face can move depending on the state of the widget.

property point CommonOffOffsetDisabled = <0,0>;

The property 'CommonOffOffsetDisabled' determines an additional displacement for areas destined to display the label text, the icon bitmap and the face bitmap when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). In this manner the label, icon and face can move depending on the state of the widget.

property point CommonOffOffsetFocused = <0,0>;

The property 'CommonOffOffsetFocused' determines an additional displacement for areas destined to display the label text, the icon bitmap and the face bitmap when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). In this manner the label, icon and face can move depending on the state of the widget.

property point CommonOnOffsetActive = <0,0>;

The property 'CommonOnOffsetActive' determines an additional displacement for areas destined to display the label text, the icon bitmap and the face bitmap when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). In this manner the label, icon and face can move depending on the state of the widget.

property point CommonOnOffsetDefault = <0,0>;

The property 'CommonOnOffsetDefault' determines an additional displacement for areas destined to display the label text, the icon bitmap and the face bitmap when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the radio button should react on). In this manner the label, icon and face can move depending on the state of the widget.

property point CommonOnOffsetDisabled = <0,0>;

The property 'CommonOnOffsetDisabled' determines an additional displacement for areas destined to display the label text, the icon bitmap and the face bitmap when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). In this manner the label, icon and face can move depending on the state of the widget.

property point CommonOnOffsetFocused = <0,0>;

The property 'CommonOnOffsetFocused' determines an additional displacement for areas destined to display the label text, the icon bitmap and the face bitmap when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). In this manner the label, icon and face can move depending on the state of the widget.

property Core::Layout FaceLayout = Core::Layout[AlignToBottom, AlignToLeft, AlignToRight, AlignToTop, ResizeHorz, ResizeVert];

The property 'FaceLayout' determines the constraints how the actually displayed face bitmap (FaceOffBitmapActive, FaceOffBitmapDefault, FaceOffBitmapDisabled, FaceOffBitmapFocused, FaceOnBitmapActive, FaceOnBitmapDefault, FaceOnBitmapDisabled or FaceOnBitmapFocused) should be aligned within the button area. Per default the bitmap fills the button widget entirely.

The constraints 'ResizeVert' and 'ResizeHorz' determine whether the bitmap should be resized to fill the button vertically and/or horizontally. Deactivating the constraint causes the button to display the bitmap with its original height and/or width. In such case you can configure with the constraints 'AlignToTop', 'AlignToBottom', 'AlignToLeft' and 'AlignToRight' how the bitmap should be aligned within the button area.

Please note, by using the properties FaceMarginLeft, FaceMarginRight, FaceMarginTop and FaceMarginBottom the area can be limited so it does not fill the entire toggle button.

property int32 FaceMarginBottom = 0;

The property 'FaceMarginBottom' determines the gap below the area to fill with the bitmap FaceOffBitmapDefault, FaceOffBitmapDisabled, FaceOffBitmapFocused, FaceOffBitmapActive, FaceOnBitmapDefault, FaceOnBitmapDisabled, FaceOnBitmapFocused or FaceOnBitmapActive. The gap is relative to the bottom edge of the button itself.

Please note, the position and the size of the area can additionally be controlled by the property FaceLayout. Furthermore, by using the properties CommonOffOffsetActive, CommonOffOffsetDefault, CommonOffOffsetDisabled, CommonOffOffsetFocused, CommonOnOffsetActive, CommonOnOffsetDefault, CommonOnOffsetDisabled and CommonOnOffsetFocused the position of the area can be adjusted for each button state individually.

property int32 FaceMarginLeft = 0;

The property 'FaceMarginLeft' determines the gap on the left of the area to fill with the bitmap FaceOffBitmapDefault, FaceOffBitmapDisabled, FaceOffBitmapFocused, FaceOffBitmapActive, FaceOnBitmapDefault, FaceOnBitmapDisabled, FaceOnBitmapFocused or FaceOnBitmapActive. The gap is relative to the left edge of the button itself.

property int32 FaceMarginRight = 0;

The property 'FaceMarginRight' determines the gap on the right of the area to fill with the bitmap FaceOffBitmapDefault, FaceOffBitmapDisabled, FaceOffBitmapFocused, FaceOffBitmapActive, FaceOnBitmapDefault, FaceOnBitmapDisabled, FaceOnBitmapFocused or FaceOnBitmapActive. The gap is relative to the right edge of the button itself.

property int32 FaceMarginTop = 0;

The property 'FaceMarginTop' determines the gap above the area to fill with the bitmap FaceOffBitmapDefault, FaceOffBitmapDisabled, FaceOffBitmapFocused, FaceOffBitmapActive, FaceOnBitmapDefault, FaceOnBitmapDisabled, FaceOnBitmapFocused or FaceOnBitmapActive. The gap is relative to the top edge of the button itself.

property Resources::Bitmap FaceOffBitmapActive = null;

The property 'FaceOffBitmapActive' determines the bitmap to fill the background of the toggle button when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button 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 FaceOffFrameActive. If the selected bitmap is intended to be animated, ensure that the property FaceOffFrameActive 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 FaceOffTintActive. With the property FaceOffTintActive you can also modulate the opacity of a regular bitmap.

Per default, the actually visible face bitmap fills the entire background area of the button. With the property FaceLayout you can modify this behavior and configure the bitmap to retain its original width and/or height. You can also determine how the bitmap should be aligned vertically and horizontally within the button area. The area can additionally be limited by using the properties FaceMarginBottom, FaceMarginLeft, FaceMarginRight, FaceMarginTop.

property Resources::Bitmap FaceOffBitmapDefault = null;

The property 'FaceOffBitmapDefault' determines the bitmap to fill the background of the toggle button when the button is switched-off and it 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 FaceOffFrameDefault. If the selected bitmap is intended to be animated, ensure that the property FaceOffFrameDefault 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 FaceOffTintDefault. With the property FaceOffTintDefault you can also modulate the opacity of a regular bitmap.

property Resources::Bitmap FaceOffBitmapDisabled = null;

The property 'FaceOffBitmapDisabled' determines the bitmap to fill the background of the toggle button when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property FaceOffFrameDisabled. If the selected bitmap is intended to be animated, ensure that the property FaceOffFrameDisabled 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 FaceOffTintDisabled. With the property FaceOffTintDisabled you can also modulate the opacity of a regular bitmap.

property Resources::Bitmap FaceOffBitmapFocused = null;

The property 'FaceOffBitmapFocused' determines the bitmap to fill the background of the toggle button when the button is switched-off and it is in the 'focused' state (the button 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 FaceOffFrameFocused. If the selected bitmap is intended to be animated, ensure that the property FaceOffFrameFocused 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 FaceOffTintFocused. With the property FaceOffTintFocused you can also modulate the opacity of a regular bitmap.

property int32 FaceOffFrameActive = -1;

The property 'FaceOffFrameActive' determines the frame number within the bitmap FaceOffBitmapActive. 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 FaceOffBitmapActive bitmap is animated, the animation is automatically started as soon as the button enters the 'active' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.

property int32 FaceOffFrameDefault = -1;

The property 'FaceOffFrameDefault' determines the frame number within the bitmap FaceOffBitmapDefault. 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 FaceOffBitmapDefault bitmap is animated, the animation is automatically started as soon as the button enters the 'default' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.

property int32 FaceOffFrameDisabled = -1;

The property 'FaceOffFrameDisabled' determines the frame number within the bitmap FaceOffBitmapDisabled. 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 FaceOffBitmapDisabled bitmap is animated, the animation is automatically started as soon as the button enters the 'disabled' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.

property int32 FaceOffFrameFocused = -1;

The property 'FaceOffFrameFocused' determines the frame number within the bitmap FaceOffBitmapFocused. 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 FaceOffBitmapFocused bitmap is animated, the animation is automatically started as soon as the button enters the 'focused' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.

property color FaceOffTintActive = #FFFFFFFF;

The property 'FaceOffTintActive' determines the color value to tint or modulate the bitmap specified in the property FaceOffBitmapActive. The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color FaceOffTintDefault = #FFFFFFFF;

The property 'FaceOffTintDefault' determines the color value to tint or modulate the bitmap specified in the property FaceOffBitmapDefault. The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color FaceOffTintDisabled = #FFFFFFFF;

The property 'FaceOffTintDisabled' determines the color value to tint or modulate the bitmap specified in the property FaceOffBitmapDisabled. The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color FaceOffTintFocused = #FFFFFFFF;

The property 'FaceOffTintFocused' determines the color value to tint or modulate the bitmap specified in the property FaceOffBitmapFocused. The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property Resources::Bitmap FaceOnBitmapActive = null;

The property 'FaceOnBitmapActive' determines the bitmap to fill the background of the toggle button when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button 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 FaceOnFrameActive. If the selected bitmap is intended to be animated, ensure that the property FaceOnFrameActive 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 FaceOnTintActive. With the property FaceOnTintActive you can also modulate the opacity of a regular bitmap.

property Resources::Bitmap FaceOnBitmapDefault = null;

The property 'FaceOnBitmapDefault' determines the bitmap to fill the background of the toggle button when the button is switched-on and it 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 FaceOnFrameDefault. If the selected bitmap is intended to be animated, ensure that the property FaceOnFrameDefault 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 FaceOnTintDefault. With the property FaceOnTintDefault you can also modulate the opacity of a regular bitmap.

property Resources::Bitmap FaceOnBitmapDisabled = null;

The property 'FaceOnBitmapDisabled' determines the bitmap to fill the background of the toggle button when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

If the specified bitmap contains more than one frame (multi-frame bitmap), the desired frame number can be selected in the property FaceOnFrameDisabled. If the selected bitmap is intended to be animated, ensure that the property FaceOnFrameDisabled 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 FaceOnTintDisabled. With the property FaceOnTintDisabled you can also modulate the opacity of a regular bitmap.

property Resources::Bitmap FaceOnBitmapFocused = null;

The property 'FaceOnBitmapFocused' determines the bitmap to fill the background of the toggle button when the button is switched-on and it is in the 'focused' state (the button 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 FaceOnFrameFocused. If the selected bitmap is intended to be animated, ensure that the property FaceOnFrameFocused 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 FaceOnTintFocused. With the property FaceOnTintFocused you can also modulate the opacity of a regular bitmap.

property int32 FaceOnFrameActive = -1;

The property 'FaceOnFrameActive' determines the frame number within the bitmap FaceOnBitmapActive. 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 FaceOnBitmapActive bitmap is animated, the animation is automatically started as soon as the button enters the 'active' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.

property int32 FaceOnFrameDefault = -1;

The property 'FaceOnFrameDefault' determines the frame number within the bitmap FaceOnBitmapDefault. 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 FaceOnBitmapDefault bitmap is animated, the animation is automatically started as soon as the button enters the 'default' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.

property int32 FaceOnFrameDisabled = -1;

The property 'FaceOnFrameDisabled' determines the frame number within the bitmap FaceOnBitmapDisabled. 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 FaceOnBitmapDisabled bitmap is animated, the animation is automatically started as soon as the button enters the 'disabled' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.

property int32 FaceOnFrameFocused = -1;

The property 'FaceOnFrameFocused' determines the frame number within the bitmap FaceOnBitmapFocused. 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 FaceOnBitmapFocused bitmap is animated, the animation is automatically started as soon as the button enters the 'focused' state. If the bitmap is not animated and the property is -1, the frame with number 0 is displayed.

property color FaceOnTintActive = #FFFFFFFF;

The property 'FaceOnTintActive' determines the color value to tint or modulate the bitmap specified in the property FaceOnBitmapActive. The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color FaceOnTintDefault = #FFFFFFFF;

The property 'FaceOnTintDefault' determines the color value to tint or modulate the bitmap specified in the property FaceOnBitmapDefault. The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color FaceOnTintDisabled = #FFFFFFFF;

The property 'FaceOnTintDisabled' determines the color value to tint or modulate the bitmap specified in the property FaceOnBitmapDisabled. The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color FaceOnTintFocused = #FFFFFFFF;

The property 'FaceOnTintFocused' determines the color value to tint or modulate the bitmap specified in the property FaceOnBitmapFocused. The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property int32 FaceStackingPriority = 1;

The property 'FaceStackingPriority' determines the Z-order position of the view destined to display the face bitmap. Per default the face view is arranged in the background of the toggle button 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 face view in front of the toggle button, configure the property with a larger value.

property Views::ImageAlignment IconAlignment = Views::ImageAlignment[AlignHorzCenter, AlignVertCenter];

The property 'IconAlignment' determines how the bitmap specified in the property 'Icon' of the button widget should be aligned.

Per default, the icon is aligned within the entire button area. By using the properties IconMarginLeft, IconMarginRight, IconMarginTop and IconMarginBottom you can limit the area as desired. Additionally the position can be adjusted for each button state individually by using the properties CommonOffOffsetActive, CommonOffOffsetDefault, CommonOffOffsetDisabled, CommonOffOffsetFocused, CommonOnOffsetActive, CommonOnOffsetDefault, CommonOnOffsetDisabled and CommonOnOffsetFocused.

property int32 IconMarginBottom = 0;

The property 'IconMarginBottom' determines the gap below the area destined to display the icon bitmap relative to the bottom edge of the button itself.

Please note, the position of the area can additionally be adjusted for each button state individually by using the properties CommonOffOffsetActive, CommonOffOffsetDefault, CommonOffOffsetDisabled, CommonOffOffsetFocused, CommonOnOffsetActive, CommonOnOffsetDefault, CommonOnOffsetDisabled and CommonOnOffsetFocused.

property int32 IconMarginLeft = 0;

The property 'IconMarginLeft' determines the gap on the left of the area destined to display the icon bitmap relative to the left edge of the button itself.

property int32 IconMarginRight = 0;

The property 'IconMarginRight' determines the gap on the right of the area destined to display the icon bitmap relative to the right edge of the button itself.

property int32 IconMarginTop = 0;

The property 'IconMarginTop' determines the gap above the area destined to display the icon bitmap relative to the top edge of the button itself.

property color IconOffTintActive = #FFFFFFFF;

The property 'IconOffTintActive' determines the color value to tint or modulate the bitmap specified in the property 'Icon' of the button widget if the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color IconOffTintDefault = #FFFFFFFF;

The property 'IconOffTintDefault' determines the color value to tint or modulate the bitmap specified in the property 'Icon' of the button widget if the button is switched-off and it is in the 'default' state. The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color IconOffTintDisabled = #FFFFFFFF;

The property 'IconOffTintDisabled' determines the color value to tint or modulate the bitmap specified in the property 'Icon' of the button widget if the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color IconOffTintFocused = #FFFFFFFF;

The property 'IconOffTintFocused' determines the color value to tint or modulate the bitmap specified in the property 'Icon' of the button widget if the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color IconOnTintActive = #FFFFFFFF;

The property 'IconOnTintActive' determines the color value to tint or modulate the bitmap specified in the property 'Icon' of the button widget if the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color IconOnTintDefault = #FFFFFFFF;

The property 'IconOnTintDefault' determines the color value to tint or modulate the bitmap specified in the property 'Icon' of the button widget if the button is switched-on and it is in the 'default' state. The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color IconOnTintDisabled = #FFFFFFFF;

The property 'IconOnTintDisabled' determines the color value to tint or modulate the bitmap specified in the property 'Icon' of the button widget if the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property color IconOnTintFocused = #FFFFFFFF;

The property 'IconOnTintFocused' determines the color value to tint or modulate the bitmap specified in the property 'Icon' of the button widget if the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). The effect of this color value depends on the type of the bitmap:

Alpha8 bitmaps will be tinted with the given color due to the fact that they don't provide their own color information. This allows one and the same Alpha8 bitmap to be shown with different colors.
In case of Native, Index8 or RGB565 bitmaps the opacity of the bitmap is modulated by the color's alpha value. The original RGB information stored in the bitmap is not affected. This allows one and the same bitmap to be shown with different transparencies.

property int32 IconStackingPriority = 4;

The property 'IconStackingPriority' determines the Z-order position of the view destined to display the icon bitmap. Per default the icon view is arranged in front of the face and thumb views (it lies in foreground). 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 icon view in the background of the toggle button, configure the property with a smaller value.

property Core::KeyCode KeyCode = Core::KeyCode.Enter;

The property 'KeyCode' determines the key, the button should react on when it is focused. In this manner the user can control the widget by using keyboard or hardware buttons.

If this property is initialized with the value Core::KeyCode.NoKey, the button will not be able to become focused and it will not receive any keyboard events.

property Views::TextAlignment LabelAlignment = Views::TextAlignment[AlignHorzCenter, AlignVertCenter];

The property 'LabelAlignment' determines how the text specified in the properties 'LabelOff' and 'LabelOn' of the button widget should be aligned.

Per default, the label is aligned within the entire button area. By using the properties LabelMarginLeft, LabelMarginRight, LabelMarginTop and LabelMarginBottom you can limit the area as desired. Additionally the position can be adjusted for each button state individually by using the properties CommonOffOffsetActive, CommonOffOffsetDefault, CommonOffOffsetDisabled, CommonOffOffsetFocused, CommonOnOffsetActive, CommonOnOffsetDefault, CommonOnOffsetDisabled and CommonOnOffsetFocused.

property int32 LabelMarginBottom = 0;

The property 'LabelMarginBottom' determines the gap below the area destined to display the label text relative to the bottom edge of the button itself.

property int32 LabelMarginLeft = 0;

The property 'LabelMarginLeft' determines the gap on the left of the area destined to display the label text relative to the left edge of the button itself.

property int32 LabelMarginRight = 0;

The property 'LabelMarginRight' determines the gap on the right of the area destined to display the label text relative to the right edge of the button itself.

property int32 LabelMarginTop = 0;

The property 'LabelMarginTop' determines the gap above the area destined to display the label text relative to the top edge of the button itself.

property color LabelOffColorActive = #000000FF;

The property 'LabelOffColorActive' determines the color value to use when the text specified in the property 'LabelOff' of the button widget is displayed and the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on).

property color LabelOffColorDefault = #000000FF;

The property 'LabelOffColorDefault' determines the color value to use when the text specified in the property 'LabelOff' of the button widget is displayed and the button is switched-off and it is in the 'default' state.

property color LabelOffColorDisabled = #000000FF;

The property 'LabelOffColorDisabled' determines the color value to use when the text specified in the property 'LabelOff' of the button widget is displayed and the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

property color LabelOffColorFocused = #000000FF;

The property 'LabelOffColorFocused' determines the color value to use when the text specified in the property 'LabelOff' of the button widget is displayed and the button is switched-off and it is in the 'focused' state (the button can react to keyboard events).

property Resources::Font LabelOffFont = null;

The property 'LabelOffFont' determines the font object used to print the text specified in the property 'LabelOff' of the button widget. This text appears only when the button is in the switched-off state. If no font is specified (the property is 'null'), no text is displayed.

property color LabelOnColorActive = #000000FF;

The property 'LabelOnColorActive' determines the color value to use when the text specified in the property 'LabelOn' of the button widget is displayed and the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on).

property color LabelOnColorDefault = #000000FF;

The property 'LabelOnColorDefault' determines the color value to use when the text specified in the property 'LabelOn' of the button widget is displayed and the button is switched-on and it is in the 'default' state.

property color LabelOnColorDisabled = #000000FF;

The property 'LabelOnColorDisabled' determines the color value to use when the text specified in the property 'LabelOn' of the button widget is displayed and the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

property color LabelOnColorFocused = #000000FF;

The property 'LabelOnColorFocused' determines the color value to use when the text specified in the property 'LabelOn' of the button widget is displayed and the button is switched-on and it is in the 'focused' state (the button can react to keyboard events).

property Resources::Font LabelOnFont = null;

The property 'LabelOnFont' determines the font object used to print the text specified in the property 'LabelOn' of the button widget. This text appears only when the button is in the switched-on state. If no font is specified (the property is 'null'), no text is displayed.

property int32 LabelStackingPriority = 5;

The property 'LabelStackingPriority' determines the Z-order position of the view destined to display the label. Per default the label view is arranged in front of the face and thumb views (it lies in foreground). 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 label view in the background of the toggle button, configure the property with a smaller value.

property bool LimitTouchArea = false;

The property 'LimitTouchArea' determines which part of the toggle button can react to touch or mouse events. When the property is 'false' the entire toggle button is touch sensitive. Configuring this property with the value 'true' limits the toggle button to react only when the user touched within an area destined for the face bitmap, track or thumb views.

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::ToggleButton. 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 int32 PressedFeedbackDuration = 50;

The property 'PressedFeedbackDuration' determines the minimum time in milliseconds how long the toggle button should appear pressed after the user has tapped it. This ensures, that the user can notice, that the button has been activated even if the user has touched it for a very short period.

property int32 StateTransitionDuration = 0;

The property 'StateTransitionDuration' controls how long do animations take when the state of the button changes. In this manner the appearance of the widget is updated smoothly (e.g. 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 views 'Track', 'TrackBorder', 'Thumb', 'ThumbBorder', 'ThumbShadow', 'Accent' and 'AccentBorder'. In case of the views 'Face', 'Label' and 'Icon' 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 Core::Layout ThumbLayout = Core::Layout[AlignToBottom, AlignToLeft, AlignToRight, AlignToTop, ResizeHorz, ResizeVert];

The property 'ThumbLayout' determines the constraints how the thumb (composed of a rectangle, border and shadow behind them) should be aligned within the button area. Per default the thumb fills the button widget entirely.

The constraints 'ResizeVert' and 'ResizeHorz' determine whether the thumb should be resized to fill the button vertically and/or horizontally. Deactivating the constraint causes the button to display the thumb with fixed height and/or width determined by the property ThumbOffSizeActive, ThumbOffSizeDefault, ThumbOffSizeDisabled, ThumbOffSizeFocused, ThumbOnSizeActive, ThumbOnSizeDefault, ThumbOnSizeDisabled or ThumbOnSizeFocused depending on the actual state of the button. With the constraints 'AlignToTop', 'AlignToBottom', 'AlignToLeft' and 'AlignToRight' the thumb can be aligned within the button area.

Please note, by using the properties ThumbOffOffsetActive, ThumbOffOffsetDefault, ThumbOffOffsetDisabled, ThumbOffOffsetFocused, ThumbOnOffsetActive, ThumbOnOffsetDefault, ThumbOnOffsetDisabled and ThumbOnOffsetFocused an additional displacement for the thumb can be determined individually for each button state.

property color ThumbOffBorderColorActive = #00000000;

The property 'ThumbOffBorderColorActive' determines the color to stroke the border surrounding the thumb when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). To determine the thickness of the border use the property ThumbOffBorderWidthActive.

property color ThumbOffBorderColorDefault = #00000000;

The property 'ThumbOffBorderColorDefault' determines the color to stroke the border surrounding the thumb when the button is switched-off and it is in the 'default' state. To determine the thickness of the border use the property ThumbOffBorderWidthDefault.

property color ThumbOffBorderColorDisabled = #00000000;

The property 'ThumbOffBorderColorDisabled' determines the color to stroke the border surrounding the thumb when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). To determine the thickness of the border use the property ThumbOffBorderWidthDisabled.

property color ThumbOffBorderColorFocused = #00000000;

The property 'ThumbOffBorderColorFocused' determines the color to stroke the border surrounding the thumb when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). To determine the thickness of the border use the property ThumbOffBorderWidthFocused.

property int32 ThumbOffBorderWidthActive = 0;

The property 'ThumbOffBorderWidthActive' determines the thickness of the border surrounding the thumb when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). The value is expressed in pixel. To determine the color of the border use the property ThumbOffBorderColorActive.

property int32 ThumbOffBorderWidthDefault = 0;

The property 'ThumbOffBorderWidthDefault' determines the thickness of the border surrounding the thumb when the button is switched-off and it is in the 'default' state. The value is expressed in pixel. To determine the color of the border use the property ThumbOffBorderColorDefault.

property int32 ThumbOffBorderWidthDisabled = 0;

The property 'ThumbOffBorderWidthDisabled' determines the thickness of the border surrounding the thumb when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The value is expressed in pixel. To determine the color of the border use the property ThumbOffBorderColorDisabled.

property int32 ThumbOffBorderWidthFocused = 0;

The property 'ThumbOffBorderWidthFocused' determines the thickness of the border surrounding the thumb when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). The value is expressed in pixel. To determine the color of the border use the property ThumbOffBorderColorFocused.

property color ThumbOffColorActive = #00000000;

The property 'ThumbOffColorActive' determines the color to fill the background of the thumb when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on).

property color ThumbOffColorDefault = #00000000;

The property 'ThumbOffColorDefault' determines the color to fill the background of the thumb when the button is switched-off and it is in the 'default' state.

property color ThumbOffColorDisabled = #00000000;

The property 'ThumbOffColorDisabled' determines the color to fill the background of the thumb when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

property color ThumbOffColorFocused = #00000000;

The property 'ThumbOffColorFocused' determines the color to fill the background of the thumb when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events).

property int32 ThumbOffCornerRadiusActive = 0;

The property 'ThumbOffCornerRadiusActive' controls the rounding at corners of the thumb when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button 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.

property int32 ThumbOffCornerRadiusDefault = 0;

The property 'ThumbOffCornerRadiusDefault' controls the rounding at corners of the thumb when the button is switched-off and it 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.

property int32 ThumbOffCornerRadiusDisabled = 0;

The property 'ThumbOffCornerRadiusDisabled' controls the rounding at corners of the thumb when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button 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.

property int32 ThumbOffCornerRadiusFocused = 0;

The property 'ThumbOffCornerRadiusFocused' controls the rounding at corners of the thumb when the button is switched-off and it is in the 'focused' state (the button 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.

property point ThumbOffOffsetActive = <0,0>;

The property 'ThumbOffOffsetActive' determines an additional displacement for the thumb when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). Unless other constraints have been specified in the property ThumbLayout, the thumb is aligned at the top-left corner of the button area. The value specified in the property ThumbOffOffsetActive is used to move the thumb accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the thumb can be modified by using the associated property ThumbOffSizeActive. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOffOffsetDefault = <0,0>;

The property 'ThumbOffOffsetDefault' determines an additional displacement for the thumb when the button is switched-off and it is in the 'default' state. Unless other constraints have been specified in the property ThumbLayout, the thumb is aligned at the top-left corner of the button area. The value specified in the property ThumbOffOffsetDefault is used to move the thumb accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the thumb can be modified by using the associated property ThumbOffSizeDefault. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOffOffsetDisabled = <0,0>;

The property 'ThumbOffOffsetDisabled' determines an additional displacement for the thumb when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). Unless other constraints have been specified in the property ThumbLayout, the thumb is aligned at the top-left corner of the button area. The value specified in the property ThumbOffOffsetDisabled is used to move the thumb accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the thumb can be modified by using the associated property ThumbOffSizeDisabled. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOffOffsetFocused = <0,0>;

The property 'ThumbOffOffsetFocused' determines an additional displacement for the thumb when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). Unless other constraints have been specified in the property ThumbLayout, the thumb is aligned at the top-left corner of the button area. The value specified in the property ThumbOffOffsetFocused is used to move the thumb accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the thumb can be modified by using the associated property ThumbOffSizeFocused. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property int32 ThumbOffShadowBlurRadiusActive = 0;

The property 'ThumbOffShadowBlurRadiusActive' determines the blur radius of the shadow behind the thumb when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). The value is expressed in pixel and it is limitted to 64 pixel.

property int32 ThumbOffShadowBlurRadiusDefault = 0;

The property 'ThumbOffShadowBlurRadiusDefault' determines the blur radius of the shadow behind the thumb when the button is switched-off and it is in the 'default' state. The value is expressed in pixel and it is limitted to 64 pixel.

property int32 ThumbOffShadowBlurRadiusDisabled = 0;

The property 'ThumbOffShadowBlurRadiusDisabled' determines the blur radius of the shadow behind the thumb when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The value is expressed in pixel and it is limitted to 64 pixel.

property int32 ThumbOffShadowBlurRadiusFocused = 0;

The property 'ThumbOffShadowBlurRadiusFocused' determines the blur radius of the shadow behind the thumb when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). The value is expressed in pixel and it is limitted to 64 pixel.

property color ThumbOffShadowColorActive = #00000000;

The property 'ThumbOffShadowColorActive' determines the color of the shadow behind the thumb when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on).

property color ThumbOffShadowColorDefault = #00000000;

The property 'ThumbOffShadowColorDefault' determines the color of the shadow behind the thumb when the button is switched-off and it is in the 'default' state.

property color ThumbOffShadowColorDisabled = #00000000;

The property 'ThumbOffShadowColorDisabled' determines the color of the shadow behind the thumb when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

property color ThumbOffShadowColorFocused = #00000000;

The property 'ThumbOffShadowColorFocused' determines the color of the shadow behind the thumb when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events).

property point ThumbOffShadowOffsetActive = <0,0>;

The property 'ThumbOffShadowOffsetActive' determines the displacement of the shadow behind the thumb when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). The value is expressed in pixel.

property point ThumbOffShadowOffsetDefault = <0,0>;

The property 'ThumbOffShadowOffsetDefault' determines the displacement of the shadow behind the thumb when the button is switched-off and it is in the 'default' state. The value is expressed in pixel.

property point ThumbOffShadowOffsetDisabled = <0,0>;

The property 'ThumbOffShadowOffsetDisabled' determines the displacement of the shadow behind the thumb when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The value is expressed in pixel.

property point ThumbOffShadowOffsetFocused = <0,0>;

The property 'ThumbOffShadowOffsetFocused' determines the displacement of the shadow behind the thumb when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). The value is expressed in pixel.

property point ThumbOffSizeActive = <0,0>;

The property 'ThumbOffSizeActive' controls the size of the thumb when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). Unless other constraints have been specified in the property ThumbLayout, the thumb fills the complete button area. With the value specified in the property ThumbOffSizeActive it is possible to enlarge the thumb. By specifying negative values in this property, the thumb will shrink accordingly. If ThumbLayout is configured to not automatically resize the thumb, the value specified in the property ThumbOffSizeActive determines the final size of the thumb. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOffOffsetActive. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOffSizeDefault = <0,0>;

The property 'ThumbOffSizeDefault' controls the size of the thumb when the button is switched-off and it is in the 'default' state. Unless other constraints have been specified in the property ThumbLayout, the thumb fills the complete button area. With the value specified in the property ThumbOffSizeDefault it is possible to enlarge the thumb. By specifying negative values in this property, the thumb will shrink accordingly. If ThumbLayout is configured to not automatically resize the thumb, the value specified in the property ThumbOffSizeDefault determines the final size of the thumb. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOffOffsetDefault. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOffSizeDisabled = <0,0>;

The property 'ThumbOffSizeDisabled' controls the size of the thumb when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). Unless other constraints have been specified in the property ThumbLayout, the thumb fills the complete button area. With the value specified in the property ThumbOffSizeDisabled it is possible to enlarge the thumb. By specifying negative values in this property, the thumb will shrink accordingly. If ThumbLayout is configured to not automatically resize the thumb, the value specified in the property ThumbOffSizeDisabled determines the final size of the thumb. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOffOffsetDisabled. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOffSizeFocused = <0,0>;

The property 'ThumbOffSizeFocused' controls the size of the thumb when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). Unless other constraints have been specified in the property ThumbLayout, the thumb fills the complete button area. With the value specified in the property ThumbOffSizeFocused it is possible to enlarge the thumb. By specifying negative values in this property, the thumb will shrink accordingly. If ThumbLayout is configured to not automatically resize the thumb, the value specified in the property ThumbOffSizeFocused determines the final size of the thumb. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOffOffsetFocused. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property color ThumbOnBorderColorActive = #00000000;

The property 'ThumbOnBorderColorActive' determines the color to stroke the border surrounding the thumb when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). To determine the thickness of the border use the property ThumbOnBorderWidthActive.

property color ThumbOnBorderColorDefault = #00000000;

The property 'ThumbOnBorderColorDefault' determines the color to stroke the border surrounding the thumb when the button is switched-on and it is in the 'default' state. To determine the thickness of the border use the property ThumbOnBorderWidthDefault.

property color ThumbOnBorderColorDisabled = #00000000;

The property 'ThumbOnBorderColorDisabled' determines the color to stroke the border surrounding the thumb when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). To determine the thickness of the border use the property ThumbOnBorderWidthDisabled.

property color ThumbOnBorderColorFocused = #00000000;

The property 'ThumbOnBorderColorFocused' determines the color to stroke the border surrounding the thumb when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). To determine the thickness of the border use the property ThumbOnBorderWidthFocused.

property int32 ThumbOnBorderWidthActive = 0;

The property 'ThumbOnBorderWidthActive' determines the thickness of the border surrounding the thumb when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). The value is expressed in pixel. To determine the color of the border use the property ThumbOnBorderColorActive.

property int32 ThumbOnBorderWidthDefault = 0;

The property 'ThumbOnBorderWidthDefault' determines the thickness of the border surrounding the thumb when the button is switched-on and it is in the 'default' state. The value is expressed in pixel. To determine the color of the border use the property ThumbOnBorderColorDefault.

property int32 ThumbOnBorderWidthDisabled = 0;

The property 'ThumbOnBorderWidthDisabled' determines the thickness of the border surrounding the thumb when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The value is expressed in pixel. To determine the color of the border use the property ThumbOnBorderColorDisabled.

property int32 ThumbOnBorderWidthFocused = 0;

The property 'ThumbOnBorderWidthFocused' determines the thickness of the border surrounding the thumb when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). The value is expressed in pixel. To determine the color of the border use the property ThumbOnBorderColorFocused.

property color ThumbOnColorActive = #00000000;

The property 'ThumbOnColorActive' determines the color to fill the background of the thumb when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on).

property color ThumbOnColorDefault = #00000000;

The property 'ThumbOnColorDefault' determines the color to fill the background of the thumb when the button is switched-on and it is in the 'default' state.

property color ThumbOnColorDisabled = #00000000;

The property 'ThumbOnColorDisabled' determines the color to fill the background of the thumb when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

property color ThumbOnColorFocused = #00000000;

The property 'ThumbOnColorFocused' determines the color to fill the background of the thumb when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events).

property int32 ThumbOnCornerRadiusActive = 0;

The property 'ThumbOnCornerRadiusActive' controls the rounding at corners of the thumb when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button 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.

property int32 ThumbOnCornerRadiusDefault = 0;

The property 'ThumbOnCornerRadiusDefault' controls the rounding at corners of the thumb when the button is switched-on and it 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.

property int32 ThumbOnCornerRadiusDisabled = 0;

The property 'ThumbOnCornerRadiusDisabled' controls the rounding at corners of the thumb when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button 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.

property int32 ThumbOnCornerRadiusFocused = 0;

The property 'ThumbOnCornerRadiusFocused' controls the rounding at corners of the thumb when the button is switched-on and it is in the 'focused' state (the button 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.

property point ThumbOnOffsetActive = <0,0>;

The property 'ThumbOnOffsetActive' determines an additional displacement for the thumb when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). Unless other constraints have been specified in the property ThumbLayout, the thumb is aligned at the top-left corner of the button area. The value specified in the property ThumbOnOffsetActive is used to move the thumb accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the thumb can be modified by using the associated property ThumbOnSizeActive. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOnOffsetDefault = <0,0>;

The property 'ThumbOnOffsetDefault' determines an additional displacement for the thumb when the button is switched-on and it is in the 'default' state. Unless other constraints have been specified in the property ThumbLayout, the thumb is aligned at the top-left corner of the button area. The value specified in the property ThumbOnOffsetDefault is used to move the thumb accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the thumb can be modified by using the associated property ThumbOnSizeDefault. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOnOffsetDisabled = <0,0>;

The property 'ThumbOnOffsetDisabled' determines an additional displacement for the thumb when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). Unless other constraints have been specified in the property ThumbLayout, the thumb is aligned at the top-left corner of the button area. The value specified in the property ThumbOnOffsetDisabled is used to move the thumb accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the thumb can be modified by using the associated property ThumbOnSizeDisabled. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOnOffsetFocused = <0,0>;

The property 'ThumbOnOffsetFocused' determines an additional displacement for the thumb when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). Unless other constraints have been specified in the property ThumbLayout, the thumb is aligned at the top-left corner of the button area. The value specified in the property ThumbOnOffsetFocused is used to move the thumb accordingly. The values are expressed in pixel.

Besides the possibility to adjust the position, also the size of the thumb can be modified by using the associated property ThumbOnSizeFocused. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property int32 ThumbOnShadowBlurRadiusActive = 0;

The property 'ThumbOnShadowBlurRadiusActive' determines the blur radius of the shadow behind the thumb when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). The value is expressed in pixel and it is limitted to 64 pixel.

property int32 ThumbOnShadowBlurRadiusDefault = 0;

The property 'ThumbOnShadowBlurRadiusDefault' determines the blur radius of the shadow behind the thumb when the button is switched-on and it is in the 'default' state. The value is expressed in pixel and it is limitted to 64 pixel.

property int32 ThumbOnShadowBlurRadiusDisabled = 0;

The property 'ThumbOnShadowBlurRadiusDisabled' determines the blur radius of the shadow behind the thumb when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The value is expressed in pixel and it is limitted to 64 pixel.

property int32 ThumbOnShadowBlurRadiusFocused = 0;

The property 'ThumbOnShadowBlurRadiusFocused' determines the blur radius of the shadow behind the thumb when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). The value is expressed in pixel and it is limitted to 64 pixel.

property color ThumbOnShadowColorActive = #00000000;

The property 'ThumbOnShadowColorActive' determines the color of the shadow behind the thumb when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on).

property color ThumbOnShadowColorDefault = #00000000;

The property 'ThumbOnShadowColorDefault' determines the color of the shadow behind the thumb when the button is switched-on and it is in the 'default' state.

property color ThumbOnShadowColorDisabled = #00000000;

The property 'ThumbOnShadowColorDisabled' determines the color of the shadow behind the thumb when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

property color ThumbOnShadowColorFocused = #00000000;

The property 'ThumbOnShadowColorFocused' determines the color of the shadow behind the thumb when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events).

property point ThumbOnShadowOffsetActive = <0,0>;

The property 'ThumbOnShadowOffsetActive' determines the displacement of the shadow behind the thumb when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). The value is expressed in pixel.

property point ThumbOnShadowOffsetDefault = <0,0>;

The property 'ThumbOnShadowOffsetDefault' determines the displacement of the shadow behind the thumb when the button is switched-on and it is in the 'default' state. The value is expressed in pixel.

property point ThumbOnShadowOffsetDisabled = <0,0>;

The property 'ThumbOnShadowOffsetDisabled' determines the displacement of the shadow behind the thumb when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The value is expressed in pixel.

property point ThumbOnShadowOffsetFocused = <0,0>;

The property 'ThumbOnShadowOffsetFocused' determines the displacement of the shadow behind the thumb when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). The value is expressed in pixel.

property point ThumbOnSizeActive = <0,0>;

The property 'ThumbOnSizeActive' controls the size of the thumb when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). Unless other constraints have been specified in the property ThumbLayout, the thumb fills the complete button area. With the value specified in the property ThumbOnSizeActive it is possible to enlarge the thumb. By specifying negative values in this property, the thumb will shrink accordingly. If ThumbLayout is configured to not automatically resize the thumb, the value specified in the property ThumbOnSizeActive determines the final size of the thumb. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOnOffsetActive. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOnSizeDefault = <0,0>;

The property 'ThumbOnSizeDefault' controls the size of the thumb when the button is switched-on and it is in the 'default' state. Unless other constraints have been specified in the property ThumbLayout, the thumb fills the complete button area. With the value specified in the property ThumbOnSizeDefault it is possible to enlarge the thumb. By specifying negative values in this property, the thumb will shrink accordingly. If ThumbLayout is configured to not automatically resize the thumb, the value specified in the property ThumbOnSizeDefault determines the final size of the thumb. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOnOffsetDefault. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOnSizeDisabled = <0,0>;

The property 'ThumbOnSizeDisabled' controls the size of the thumb when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). Unless other constraints have been specified in the property ThumbLayout, the thumb fills the complete button area. With the value specified in the property ThumbOnSizeDisabled it is possible to enlarge the thumb. By specifying negative values in this property, the thumb will shrink accordingly. If ThumbLayout is configured to not automatically resize the thumb, the value specified in the property ThumbOnSizeDisabled determines the final size of the thumb. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOnOffsetDisabled. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property point ThumbOnSizeFocused = <0,0>;

The property 'ThumbOnSizeFocused' controls the size of the thumb when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). Unless other constraints have been specified in the property ThumbLayout, the thumb fills the complete button area. With the value specified in the property ThumbOnSizeFocused it is possible to enlarge the thumb. By specifying negative values in this property, the thumb will shrink accordingly. If ThumbLayout is configured to not automatically resize the thumb, the value specified in the property ThumbOnSizeFocused determines the final size of the thumb. The values are expressed in pixel.

Besides the possibility to adjust the size, also the position of the thumb can be modified by using the associated property ThumbOnOffsetFocused. In this manner the button can be configured with a thumb changing its position and size depending on the state of the widget.

property int32 ThumbStackingPriority = 3;

The property 'ThumbStackingPriority' determines the Z-order position of the views destined to display the thumb (rectangle, border and shadow). Per default all thumb views are arranged in front of the 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 thumb views in background of the toggle button, configure the property with a smaller value.

property int32 TrackCornerRadius = 0;

The property 'TrackCornerRadius' controls the rounding at corners of the track. Normally, the track 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. 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 track.

property Core::Layout TrackLayout = Core::Layout[AlignToBottom, AlignToLeft, AlignToRight, AlignToTop, ResizeHorz, ResizeVert];

The property 'TrackLayout' determines the constraints how the track should be aligned within the button area. Per default the track (composed of a rectangle and a border) fills the button widget entirely and is arranged behind the thumb.

The constraints 'ResizeVert' and 'ResizeHorz' determine whether the track should be resized to fill the button vertically and/or horizontally. Deactivating the constraint causes the button to display the track with fixed height and/or width determined by the property TrackSize. With the constraints 'AlignToTop', 'AlignToBottom', 'AlignToLeft' and 'AlignToRight' the track can be aligned within the button area.

Please note, by using the property TrackOffset an additional displacement for the track can be determined.

property color TrackOffBorderColorActive = #00000000;

The property 'TrackOffBorderColorActive' determines the color to stroke the border surrounding the track when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). To determine the thickness of the border use the property TrackOffBorderWidthActive.

property color TrackOffBorderColorDefault = #00000000;

The property 'TrackOffBorderColorDefault' determines the color to stroke the border surrounding the track when the button is switched-off and it is in the 'default' state. To determine the thickness of the border use the property TrackOffBorderWidthDefault.

property color TrackOffBorderColorDisabled = #00000000;

The property 'TrackOffBorderColorDisabled' determines the color to stroke the border surrounding the track when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). To determine the thickness of the border use the property TrackOffBorderWidthDisabled.

property color TrackOffBorderColorFocused = #00000000;

The property 'TrackOffBorderColorFocused' determines the color to stroke the border surrounding the track when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). To determine the thickness of the border use the property TrackOffBorderWidthFocused.

property int32 TrackOffBorderWidthActive = 0;

The property 'TrackOffBorderWidthActive' determines the thickness of the border surrounding the track when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). The value is expressed in pixel. To determine the color of the border use the property TrackOffBorderColorActive.

property int32 TrackOffBorderWidthDefault = 0;

The property 'TrackOffBorderWidthDefault' determines the thickness of the border surrounding the track when the button is switched-off and it is in the 'default' state. The value is expressed in pixel. To determine the color of the border use the property TrackOffBorderColorDefault.

property int32 TrackOffBorderWidthDisabled = 0;

The property 'TrackOffBorderWidthDisabled' determines the thickness of the border surrounding the track when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The value is expressed in pixel. To determine the color of the border use the property TrackOffBorderColorDisabled.

property int32 TrackOffBorderWidthFocused = 0;

The property 'TrackOffBorderWidthFocused' determines the thickness of the border surrounding the track when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events). The value is expressed in pixel. To determine the color of the border use the property TrackOffBorderColorFocused.

property color TrackOffColorActive = #00000000;

The property 'TrackOffColorActive' determines the color to fill the background of the track when the button is switched-off and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on).

property color TrackOffColorDefault = #00000000;

The property 'TrackOffColorDefault' determines the color to fill the background of the track when the button is switched-off and it is in the 'default' state.

property color TrackOffColorDisabled = #00000000;

The property 'TrackOffColorDisabled' determines the color to fill the background of the track when the button is switched-off and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

property color TrackOffColorFocused = #00000000;

The property 'TrackOffColorFocused' determines the color to fill the background of the track when the button is switched-off and it is in the 'focused' state (the button can react to keyboard events).

property point TrackOffset = <0,0>;

The property 'TrackOffset' determines an additional displacement for the track. Unless other constraints have been specified in the property TrackLayout, the track is aligned at the top-left corner of the button area. The value specified in the property TrackOffset is used to move the track accordingly. The values are expressed in pixel. Besides the possibility to adjust the position, also the size of the track can be modified by using the associated property TrackSize.

property color TrackOnBorderColorActive = #00000000;

The property 'TrackOnBorderColorActive' determines the color to stroke the border surrounding the track when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). To determine the thickness of the border use the property TrackOnBorderWidthActive.

property color TrackOnBorderColorDefault = #00000000;

The property 'TrackOnBorderColorDefault' determines the color to stroke the border surrounding the track when the button is switched-on and it is in the 'default' state. To determine the thickness of the border use the property TrackOnBorderWidthDefault.

property color TrackOnBorderColorDisabled = #00000000;

The property 'TrackOnBorderColorDisabled' determines the color to stroke the border surrounding the track when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). To determine the thickness of the border use the property TrackOnBorderWidthDisabled.

property color TrackOnBorderColorFocused = #00000000;

The property 'TrackOnBorderColorFocused' determines the color to stroke the border surrounding the track when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). To determine the thickness of the border use the property TrackOnBorderWidthFocused.

property int32 TrackOnBorderWidthActive = 0;

The property 'TrackOnBorderWidthActive' determines the thickness of the border surrounding the track when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on). The value is expressed in pixel. To determine the color of the border use the property TrackOnBorderColorActive.

property int32 TrackOnBorderWidthDefault = 0;

The property 'TrackOnBorderWidthDefault' determines the thickness of the border surrounding the track when the button is switched-on and it is in the 'default' state. The value is expressed in pixel. To determine the color of the border use the property TrackOnBorderColorDefault.

property int32 TrackOnBorderWidthDisabled = 0;

The property 'TrackOnBorderWidthDisabled' determines the thickness of the border surrounding the track when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false'). The value is expressed in pixel. To determine the color of the border use the property TrackOnBorderColorDisabled.

property int32 TrackOnBorderWidthFocused = 0;

The property 'TrackOnBorderWidthFocused' determines the thickness of the border surrounding the track when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events). The value is expressed in pixel. To determine the color of the border use the property TrackOnBorderColorFocused.

property color TrackOnColorActive = #00000000;

The property 'TrackOnColorActive' determines the color to fill the background of the track when the button is switched-on and it is in the 'active' state (the user is actually touching the button or pressing a key on the keyboard the toggle button should react on).

property color TrackOnColorDefault = #00000000;

The property 'TrackOnColorDefault' determines the color to fill the background of the track when the button is switched-on and it is in the 'default' state.

property color TrackOnColorDisabled = #00000000;

The property 'TrackOnColorDisabled' determines the color to fill the background of the track when the button is switched-on and it is in the 'disabled' state (property 'Enabled' of the button is 'false').

property color TrackOnColorFocused = #00000000;

The property 'TrackOnColorFocused' determines the color to fill the background of the track when the button is switched-on and it is in the 'focused' state (the button can react to keyboard events).

property point TrackSize = <0,0>;

The property 'TrackSize' controls the size of the track. Unless other constraints have been specified in the property TrackLayout, the track fills the complete button area. With the value specified in the property TrackSize it is possible to enlarge the track. By specifying negative values in this property, the track will shrink accordingly. If TrackLayout is configured to not automatically resize the track, the value specified in the property TrackSize determines the final size of the track. The values are expressed in pixel.

property int32 TrackStackingPriority = 2;

The property 'TrackStackingPriority' determines the Z-order position of the views destined to display the track (rectangle and border). Per default all track views are arranged in front of the face view just behind the thumb 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 track views in background of the toggle button, configure the property with a smaller value.

property point WidgetMaxSize = <0,0>;

The property 'WidgetMaxSize' determines the maximum allowed size of the widget. Accordingly, the button can't become bigger than the value specified in this property. By using this property you can configure the size constraints for the button.

property point WidgetMinSize = <0,0>;

The property 'WidgetMinSize' determines the minimal allowed size of the widget. Accordingly, the button can't become smaller than the value specified in this property. By using this property you can configure the size constraints for the button.