APP_POPUP: Right-Mouse Menu Control

Use the APP_POPUP package to add entries on the right-mouse menus. Entries you add using this package appear between the Folder and the Help entries of the default right-mouse menu for text items.

See: Customizing Right-Mouse Menus (Popup Menus)

APP_POPUP.INSTANTIATE

Summary
procedure APP_SPECIAL.INSTANTIATE(
          option_name        varchar2,
          txt                varchar2,
          initially_enabled  boolean  default true,
          separator          varchar2 default null);
Description

This procedure allows you to add up to 10 custom entries to the default right-mouse menu on a text item.

Call this procedure in a block- or item-level PRE-POPUP-MENU trigger. Set the Execution Hierarchy of the trigger to After so your trigger fires after the form-level PRE-POPUP-MENU trigger (which must fire first to check that the user clicked over the field that currently has focus and to set the menu to its default state).

Arguments (input)
option_name POPUP1 to POPUP10, where POPUP1 is the topmost entry of the ten customizable entries (just below the Folder entry), and POPUP10 is at the bottom (just above the Help entry).
txt Your menu item label. Pass a translated string (if your form is to be translated, you should define a message in Message Dictionary, retrieve the message first, and pass the retrieved message string to APP_POPUP).
initially_enabled A boolean value that lets you set the status of the menu item. If you do not want to enable the item, pass FALSE.
separator Pass 'LINE' to display a menu separator line above your menu entry. Note that the separator line above the first custom entry (just below the Folder entry) is displayed automatically.
Example
APP_POPUP.INSTANTIATE('POPUP1','First Entry'); 
APP_POPUP.INSTANTIATE('POPUP2','Second Entry', TRUE,
                      'LINE'); 
APP_POPUP.INSTANTIATE('POPUP3','Third Entry', FALSE);

results in a menu that looks like the following:

  ------------
	Cut
	Copy
	Paste
	------------
	Folder
	------------
	First Entry
	------------
	Second Entry
	Third Entry   (disabled, so greyed out)
	------------
	Help
	------------