Action Statement

Set the currently active region, dialog box, dialog control, or table.

activate OBJECT_NAME

 

OBJECT_NAME

The identifier for a framed region, dialog box, dialog control, or table.

Description

Activating a framed region places the region on top of its siblings with equal priority, and changes the appearance of its title bar and size border. If the region has an active sibling, that sibling is deactivated. A region is automatically activated when the region is selected with the mouse.

Activating a dialog control moves the keyboard focus to that control. You can activate a dialog control to direct the user to re-enter data that has been entered incorrectly into an entry field.

You can use this statement to activate modeless dialog boxes.

If you activate a table, the current cell will be the same as the last time the table was active or otherwise changed.

Example

 

...

default push button OK_PB

 size 38 12

 at position 6 4

 in Logon_DB

 group is Actions

 text "~OK"

 

entry field User_ID_EF

 size 52 14

 at position 96 63

 in Logon_DB

 text size 10 columns

 left align

 

response to OK_PB in Logon_DB

 if (text of User_ID_EF = "") then

         activate User_ID_EF

         ...

 end if

See Also

response to OBJECT Response Definition