ThisMenu

A data structure that provides information about the state of the system and of the current menu at the time of the last event in that menu.

The ThisMenu data structure provides information about the state of the system and of the current menu at the time of the last event in the current window.

The ThisMenu structure contains a number of fields that are reset when the current window changes. An application program can use the information in the fields to determine what action, if any, to take.

The fields in the ThisMenu structure are:

MenuChanged, MenuItemNum, MenuItemTag, MenuNum, MenuTag

Syntax #1 – MenuChanged

Indicates if any menu item in the current menu had been modified by the application user at the time of the last

thismenu.menuchanged

Return Value

“1” ($True), or “0” ($False). Can be reset by an application program.

Description

Set to “1” ($True) if the value of any menu item in the current menu changed after the application user was placed in control of the interface. Otherwise, set to “0” ($False).

Syntax #2 – MenuItemNum

The identification number of the selected menu item on the menu at the time of the last event in the current window.

thsimenu.menuitemnum

Return Value

A number. Can be reset by an application program.

Description

The identification number of the selected item on the menu at the time of the last event in the current window.

The combination of ThisMenu.MenuItemNum and ThisMenu.MenuNum can uniquely identify a particular menu selection.

Syntax #3 – MenuItemTag

The tag of the selected menu item on the menu at the time of the last event in the current window.

thismenu.menuitemtag

Return Value

A character string. Can be reset by an application program.

Description

The identification tag of the selected item on the menu at the time of the last event in the current window.

Syntax #4 – MenuNum

The identification number of the current menu at the time of the last event in the current window.

thismenu.menunum

Return Value

A number. Can be reset by an application program.

Description

The identification number of the current menu at the time of the last event in the current window.

The combination of ThisMenu.MenuItemNum and ThisMenu.MenuNum uniquely identify a particular menu selection.

Syntax #5 – MenuTag

The tag of the current menu at the time of the last event in the current window.

thismenu.menutag

Return Value

A character string. Can be reset by an application program.

Description

The identification tag of the current menu at the time of the last event in the current window.

See Also

FORM INPUT

FORM SET

MENU INPUT

MENU SET

SCREEN CLEAR

SCREEN RESET

ThisForm

ThisWindow

WINDOW CLOSE

WINDOW OPEN

WINDOW SET

WINDOW SET CURRENT