4D Doc Center : GET MENU ITEMS

Home

4D v14.3

GET MENU ITEMS


GET MENU ITEMS ( menu ; menuTitlesArray ; menuRefsArray )

Parameter	Type	Description
menu	Longint, MenuRef	Menu reference or Menu number
menuTitlesArray	String array	Array of menu titles
menuRefsArray	String array	Array of menu references

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)