Button Control

A button control is a visual component of a screen that can be clicked by the user and responded to with action script. Examples of button controls can be seen below:

 

            

 

Additional features of the button control can be found in the following two categories:

 

Notification Messages

A notification message is triggered whenever the user interacts with a control, or whenever user interaction affects a control in some way. Each notification message consists of a number that identifies the type of interaction that has occurred, and a table containing details specific to that type of interaction. These two values are passed to the screen's On Ctrl Message event as the event variables e_MsgID and e_Details.

Note: Notification messages are not triggered when actions interact with this control.

(number) e_MsgID
A numeric constant that represents the specific notification message that was fired by the screen control. See the e_MsgID column below for all possible message ids that can be fired by a button control.

(table) e_Details
A table of a
dditional details that may be passed by the control when certain notification messages are fired. See the e_Details column below for the kinds of details that are returned and the table indexes that you can use to access them.

e_MsgID

e_Details

Description

MSGID_CLICKED

nil

Fired when the button was clicked.

Related Actions

The following actions are available for interacting with a button control:

 

DlgButton.GetProperties

DlgButton.SetProperties