Pop-up menu methods support the actions that the user can perform on an object. These actions appear in a context or pop-up menu when the user presses button 2 of the pointing device. A pop-up menu contains action choices for an object in its current context or state. The contents of a pop-up menu depends on the state of the object.

Pop-up menus consist of a set of selectable items and any pull-down or conditional cascaded menus associated with them. In the following figure, Open, Settings, Open parent, Refresh now, and so on, are items in the object's primary pop-up menu. Icon, Tree, and Details are items in the Open pull-down or conditional cascaded menu.

Conditional cascaded menus have mini-push buttons displayed next to the pop-up menu item. When the user selects the mini-push button, the pull-down menu is displayed. As shown in the above figure, Open, Help, and Sort have mini-push buttons that are represented by a right arrow () surrounded by a square box. If the user selects one of these three pop-up menu items, a default action listed in the submenu is performed. The default action is represented by a check mark. The default action for the Open item is Icon view, the Help item is General help, and the Sort item is Name. This submenu is called a conditional cascaded menu because it is displayed only if the user selects the mini-push button.

Like Settings notebook pages, pop-up menus are inherited from a class' ancestor classes. This means that they include pop-up menu items that ancestor classes have added to or removed from the pop-up menu inherited from WPObject. The pop-up methods permit you to add new menu items to or remove menu items from the pop-up menu inherited from an object's ancestor classes, as shown in the following table:

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³Method                   ³Description                        ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpAddUserItemsToPopupMenu³Adds user-defined items to the     ³
³                         ³popup menu.                        ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpFilterMenu             ³Filters out options from the       ³
³                         ³object's pop-up menu that do not   ³
³                         ³apply.  (OS/2 Version 4 or higher.)³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpFilterPopupMenu        ³Filters out options from the       ³
³                         ³object's pop-up menu that do not   ³
³                         ³apply.                             ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpInsertMenuItems        ³Inserts items into the object's    ³
³                         ³pop-up menu.  (OS/2 Version 4 or   ³
³                         ³higher.)                           ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpInsertPopupMenuItems   ³Inserts items into the object's    ³
³                         ³pop-up menu.                       ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpModifyMenu             ³Adds new options to the object's   ³
³                         ³pop-up menu.  (OS/2 Version 4 or   ³
³                         ³higher.)                           ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpModifyPopupMenu        ³Adds new options to the object's   ³
³                         ³pop-up menu.                       ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpSetMenuStyle           ³Sets the menu style to be either   ³
³                         ³long or short.                     ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

When the user requests an object's pop-up menu, the Workplace Shell builds it by calling the object's wpFilterPopupMenu and wpModifyPopupMenu. The wpInsertPopupMenuItems method is called by an override to wpModifyPopupMenu to add new options to an object's pop-up menu.


[Back] [Next]