Oracle Forms Developer – Form Builder Reference, Volume 1

GET_MENU_ITEM_PROPERTY built-in
Description
Returns the state of the menu item given the specific property. You can use this built-in function to get
the state and then you can change the state of the property with the SET_MENU_ITEM_PROPERTY
built-in.
Syntax
FUNCTION GET_MENU_ITEM_PROPERTY
(menuitem_id MenuItem,
property NUMBER);
FUNCTION GET_MENU_ITEM_PROPERTY
(menu_name.menuitem_name VARCHAR2,
property NUMBER);
Built-in Type unrestricted function
Returns VARCHAR2
Enter Query Mode yes
Parameters
menuitem_id The unique ID Form Builder assigns to the menu item when you create it.
Use the FIND_MENU_ITEM built-in to return the ID to an appropriately
typed variable. Datatype is MenuItem.
menu_name. menuitem_nameThe name you gave the menu item when you created it. If you specify the
menu item by name, include the qualifying menu name, for example,
menu_name.menuitem_name. Datatype is VARCHAR2.
property Specify one of the following constants to retrieve information about the
menu item:
GET_MENU_ITEM_PROPERTY examples
204
CHECKED Returns the VARCHAR2 string TRUE if a check box menu
item is checked, FALSE if it is unchecked. Returns the VARCHAR2 string
TRUE if a radio menu item is the selected item in the radio group, FALSE
if some other radio item in the group is selected. Returns TRUE for other
menu item types.
ENABLED Returns the VARCHAR2 string TRUE if a menu item is
enabled, FALSE if it is disabled (thus grayed out and unavailable).
ICON_NAME Returns the file name of the icon resource associated with a
menu item having the Icon in Menu property set to TRUE.
LABEL Returns the VARCHAR2 string for the menu item label.
VISIBLE Returns the VARCHAR2 string TRUE if a menu item is visible,
FALSE if it is hidden from view.