|
Property
|
Description
|
Mobile Support
|
|
3 States
|
Specifies whether to support a three-state display.
In runtime, the three states are displayed as follows:
False – Not checked or not pressed
True – Checked or pressed
Null – Checked or pressed, but grayed out
To define a three-state behavior for a control, the Null Allowed property should be set to Yes in the assigned variable.
This property’s default value is False.
|
|
|
Font
|
The font for the control's text taken from the Application Font repository.
Platform specific: On Android and iOS devices: The font size defined in Magic xpa is converted to pixels on the mobile device using the following formula: (font size on mobile in pixels) = (font size on Windows in points)*(device dpi)/72.
|
Android, iOS and Windows 10 Mobile
|
|
Color
|
The color of the control taken from the Application Color repository.
Platform specific: In mobile devices, when a system color is used it will show the operating system's default color for the control.
For Android devices, you can change the native color of the check box. For more information, see: Native Color Customization.
|
Android, iOS and Windows 10 Mobile
|
|
Help Screen
|
Specifies whether a Help screen is associated with this control.
For Rich Client controls, only help screens of Type=URL are supported.
In Rich Client controls, the URL can point to a server file and not to a Web location. (Since version: 1.9)
|
|
|
Tooltip
|
Specifies whether a ToolTip is associated with this control. A number specifies the number of the ToolTip Help in the Help list.
You can create the expression in Unicode format.
|
|
|
Help Prompt
|
Specifies whether a Help prompt is associated with this control.
| |
|
Visible
|
Specifies whether the control will be visible to the user.
|
Android, iOS and Windows 10 Mobile
|
|
Enabled
|
Specifies whether the control will be active.
|
Android, iOS and Windows 10 Mobile
|
|
Appearance
|
The appearance of the control. The options are:
Box (default) – The Windows Check Box control is displayed as a regular check box that displays one of the three State options.
Button – The control will be displayed as a button. The button is displayed as pressed when the value of the attached data is True, and appears as not pressed when the value is False.
Switch – The control will be displayed as a switch box. This option is supported on Android devices only. If this option is set, then when executed on a Windows device, a Box appearance will be used. Note that the text will be to the left of the control. Since version: 3.1
Platform specific:
-
For iOS devices, the appearance will always be Switch, regardless of the value set in this property.
-
For Android and Windows 10 Mobile devices, the Box and Switch options are supported. A Button appearance will be seen as Box.
|
Android and Windows 10 Mobile
|
|
Style
|
The style of the control. The options are:
Note that under XP Theme, these styles look the same.
See also: Use Windows XP Theme environment setting.
|
|
|
Border Style
|
Defines the style of the control’s border. The valid values are:
Thin – Surrounds the control with a thin line.
Thick – Surrounds the control with a thick line.
No Border – Leaves the control without a visible border.
Since version: 3.2
|
|
|
Horizontal Alignment
|
The horizontal alignment of the text in the control. The options are Left (default), Center, and Right.
|
|
|
Vertical Alignment
|
The vertical alignment of the text in the control. The options are Top, Center (default), and Bottom.
|
|
|
Image File Name
|
The image file that will be shown on the control when running on Windows. If you are developing for mobile devices, define your file in the Image List file name property.
The image is displayed in its original size and is aligned in the control according to the Vertical and Horizontal Alignment property values.
|
|
