A script-enabled browser is required for this page to function properly.

SET_MENU_ITEM_PROPERTY Built-in

Description

Modifies the given properties of a menu item.

Syntax

SET_MENU_ITEM_PROPERTY
(menuitem_id MenuItem,
property
NUMBER,
value
NUMBER);

SET_MENU_ITEM_PROPERTY
(menu_name.menuitem_name VARCHAR2,
property
NUMBER,
value
NUMBER);

SET_MENU_ITEM_PROPERTY
(menuitem_id MenuItem,
property
NUMBER,
value
VARCHAR2);

SET_MENU_ITEM_PROPERTY
(menu_name.menuitem_name VARCHAR2,
property
NUMBER,
value
VARCHAR2);

Built-in Type unrestricted procedure

Enter Query Mode yes

Parameters

menuitem_id 
 
Specifies the unique ID Oracle Forms assigns when it creates the menu item. Use the FIND_MENU_ITEM Built-in to return the ID to an appropriately typed variable. The data type of the ID is MenuItem.
 
menu_name.menuitem_name 
 
Specifies the VARCHAR2 name you gave to the menu item when you defined it. If you specify the menu item by name, include the qualifying menu name, as shown in the syntax.
 
property 
 
Specify one of the following constants to set information about the menu item:

CHECKED Specifies the Checked property, which indicates if a check box menu item or a radio menu item is in the checked state or unchecked state.

ENABLED Specifies whether the menu item is enabled (thus active) or disabled (thus greyed out and unavailable to the operator).

ICON_IN_HTOOLBAR Specifies whether the menu item appears (represented by an icon) on the horizontal menu toolbar of a form.

ICON_IN_MENU Specifies whether an icon is displayed in the menu beside the menu item. If Yes, the Icon Filename property specifies the icon that will be displayed.

ICON_IN_VTOOLBAR Specifies whether the menu item appears (represented by an icon) on the vertical menu toolbar of a form.

ICON_NAME Specifies the file name of the icon resource associated with a menu item having the Icon in Menu property set to TRUE.

LABEL Specifies the character string for the menu item label.

VISIBLE Specifies whether the menu item is visibly displayed.

 
value 
 
Specify one of the following constants or an appropriate character string:

PROPERTY_TRUE Specifies that the property is to be set to the TRUE state.

PROPERTY_FALSE Specifies that the property is to be set to the FALSE state.

SET_MENU_ITEM_PROPERTY Restrictions

These restrictions apply only if the menu module's Use Security property is set to Yes:

SET_MENU_ITEM_PROPERTY Examples

/*

** Built-in: SET_MENU_ITEM_PROPERTY
** See also GET_MENU_ITEM_PROPERTY
*/

PROCEDURE Rename_Menuitem( menuitem_name VARCHAR2) IS 
mi_id MenuItem; 
BEGIN
mi_id := Find_Menu_Item( menuitem_name ); 
	IF Get_Menu_Item_Property(mi_id,LABEL) = 'MENUITEM1' THEN 
    	Set_Menu_Item_Property(mi_id,LABEL,'MENUITEM2'); 
    	ELSE 
    	Set_Menu_Item_Property(mi_id,LABEL,'MENUITEM3'); 
   	END IF; 
END;