Work Area: _childPopup

Work Area: _childPopup

Displays a pop-up menu containing choices supplied by the Work Area class or defined by the user. Overrides _childPopup in the Widget class.

Syntax
Details

Syntax

CALLSUPER(_SELF_, '_childPopup', fill-list, widget-id, sel);

Argument Type Description

fill-list
N specifies the identifier of an SCL list containing the pop-up menu items

widget-id
N specifies the identifier of the widget that received the original _popup method

sel
N returns the selected pop-up menu item

Argument	Type	Description
fill-list	N	specifies the identifier of an SCL list containing the pop-up menu items
widget-id	N	specifies the identifier of the widget that received the original _popup method
sel	N	returns the selected pop-up menu item

Details

The _childPopup method is run by the WIDGET class when the user causes the WPOPUP event (usually with a mouse button) on a work area item. The method has the opportunity to modify the list of pop-up menu items passed in and then pass the fill-list on up the class hierarchy to be handled by the base Work Area class. After the CALL SUPER, sel is set to the index of the selected item from the pop-up menu. If that selection belongs to this method, the selection should be handled, the fill-list cleaned up and selection set to 0 before returning. It is important that the fill-list and sel returned from this method be consistent with the fill-list that was passed into the method. See the _popUp method for an example.

By default, _childPopup for a newly added item adds the following items to the menu:

Attributes

Region Attributes

Remove

Copy

Move

For a description of these items, see Work Area Run-time Menus.

Chapter Contents
Previous
Next
Top of Page