Salesforce

Push Button Details Properties (Magic xpa 4.x)

« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

Push Button Details Properties (Magic xpa 4.x)

Property

Description

Mobile Support

Data

The variable or expression associated with the control.

Android and iOS

Variable Name

This read-only property shows the variable name as selected in the Data property.

Android and iOS

Control Name

The control name is used by handlers and functions to refer to the control.
Unicode is not supported for this property.

In Web Client tasks, this field must not start with a digit, or contain spaces or the special characters !,+:,~{}>\".

In Web Client tasks, the controls for which data is not required, this property contains a default control name as Buttonxxxxxxxx, where xxxxxxxx is the ISN of this control.

Android and iOS

Format

The display format of the data.

The property can inherit a value from the format of the data or the model.

The initial setting is the Picture inherited from the item's Column repository setting.

When a Push Button has no variable in the Data property, the Format property determines the content that will be displayed on the Push Button. The ampersand (&) character is used as a shortcut key for the Push Button control. The letter after the ampersand will be underlined. During runtime, pressing Alt + shortcut key (underlined letter) will activate the push button. This is very useful when the push button has no variable in the Data property, and therefore the push button is not parkable.

See also How Do I Set Accelerators to Push Buttons?

Android and iOS

Attribute

The attribute of the selected variable or expression. The Attribute property is fixed for variables. You can change the setting for items based on an expression.

Android and iOS

Button Style

The style of the button. For more information, see Button Style.

Android and iOS

Default Image File

The image file that will be displayed on the control.

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 available in Online tasks only and is effective at runtime only if the control does not have a variable in the Data property. If a variable is attached to the Data property of the control, then the variable value defines the image path.

Image List file name

The image file that will be displayed on the control in the Studio only. The image file is taken from the server.

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 available in Rich Client tasks only.

Since version: 1.9

Android and iOS

Image File

This is same as Image File for Image control.

This property is available in Web Client tasks only.

Since version: 4.0

Event Type

Defines the type of event that will be raised when the control or operation is executed. For information about the various options, see Event Type. Since version: 3.0

Android and iOS

Event

Defines the event that will be raised when the control or operation is executed. You can zoom from this property to select a User event. Since version: 3.0

Android and iOS

Arguments

The arguments that will be sent to the event handler once the event is invoked. The Arguments property displays the number of arguments passed from the raised event. You can zoom from this property to the Argument repository to pass the required arguments.

Note that Push Button events behave as Wait=No, so the arguments will not be returned.

Since version: 1.5

Android and iOS

Raise at

Specifies where the event will be raised at. The optional values are:

Container task (default value) – Triggers an event for the task that has the Push Button control assigned.

Task in focus – Triggers an event for the task in focus (even if the push button was defined in another task).

For additional information, see Raise At.

Custom Properties

It is a Read-Only, free-floating property that displays the number of items in the custom properties list for this specific form or control. You can access it by zooming-in to it.

Since version: 4.0

See also: Web Client Custom Properties Property

Context Menu

The context menu to be used for the control. When a context menu is defined, it will override the default OS context menu.

This property is not available in Web Client tasks.

See also Context Menu.

Allow Drag

Enables the dragging of data from the control to other controls in the same project or other projects that run on the same machine. The data copied from this control can be set manually by defining a handler over the Drag begin event, or automatically by the Magic xpa engine.

Note: An expression set for this property is only evaluated when the task is loaded.

See also:

How Do I Copy Data Within an Application by Dragging It?

How Do I Drag Data from Magic xpa to External Applications?

Rich Client support: Since version: 2.0

This property is not available in Web Client tasks.

Allow Drop

Enables the dropping of data onto the control from other controls in the same project or other projects that run on the same machine. The data copied onto this control can be set manually by defining a handler over the Drop event, or automatically by the Magic xpa engine.

Note: An expression set for this property is only evaluated when the task is loaded.

See also How Do I Drag Data from External Applications to Magic xpa?

Rich Client support: Since version: 2.0

This property is not available in Web Client tasks.

Reference
Attachment 
Attachment