Salesforce

Check Box Appearance Control Properties (Magic xpa 4.x)

« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

Check Box Appearance Control Properties (Magic xpa 4.x)

Property

Description

Mobile Support

3 State

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.

This property is not available in Web Client tasks.

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.

This property is not available in Web Client tasks.

Android and iOS

Color

The color of the control taken from the Application Color repository.

For Android devices, you can change the native color of the check box. For more information, see: Native Color Customization.

This property is not available in Web Client tasks.

Android and iOS

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)

This property is not available in Web Client tasks.

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.

This property is not available in Web Client tasks.

Visible

Specifies whether the control will be visible to the user.

Android and iOS

Enabled

Specifies whether the control will be active.

Android and iOS

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 devices, the Box and Switch options are supported. A Button appearance will be seen as Box.

This property is not available in Web Client tasks.

Android

Android and iOS

Style

The style of the control. The options are:

  • 2-D

  • 3-D Sunken (default)

Note that under XP Theme, these styles look the same.

See also: Use Windows XP Theme environment setting.

This property is not available in Web Client tasks.

Owner Drawn

Defines whether the Check box is owner-drawn.

When a Check box with Owner Drawn property is set to True, Style property is set as 3-D Sunken and is disabled, and Appearance property is set as Box and is disabled.

This property is available only in Online and RC tasks.

Since version: 4.6

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

This property is not available in Web Client tasks.

Horizontal Alignment

The horizontal alignment of the text in the control. The options are Left (default), Center, and Right.

This property is not available in Web Client tasks.

Vertical Alignment

The vertical alignment of the text in the control. The options are Top, Center (default), and Bottom.

This property is not available in Web Client tasks.

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.

This property is not available in Web Client tasks.

Reference
Attachment 
Attachment