ThisMenu
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