Skip to main content
Version: Next

GET MENU ITEMS

GET MENU ITEMS ( menu ; menuTitlesArray ; menuRefsArray )

ParameterTypeDescription
menuInteger, TextMenu reference or Menu number
menuTitlesArrayText arrayArray of menu titles
menuRefsArrayText arrayArray of menu references

This command is not thread-safe, it cannot be used in preemptive code.

Description

The GET MENU ITEMS command returns, in the menuTitlesArray and menuRefsArray arrays, the titles and IDs of all the items of the menu or menu bar designated by the menu parameter.

In the menu parameter, you can pass a menu reference (MenuRef), a menu bar number or a menu bar reference obtained using the Get menu bar reference command.

If no menu reference is associated with an item, an empty string is returned in the corresponding array element.

Example

You want to find out the contents of the menu bar of the current process:

 ARRAY TEXT(menuTitlesArray;0)
 ARRAY TEXT(menuRefsArray;0)
 MenuBarRef:=Get menu bar reference(Frontmost process)
 GET MENU ITEMS(MenuBarRef;menuTitlesArray;menuRefsArray)