Chapter Contents

Previous

Next
Widget Class: _childPopup

Widget Class: _childPopup



Displays a pop-up menu containing character items in an SCL list


Syntax
Details

Syntax

objectName._childPopup( itemsList, objectID, selection );

Argument Type Use Description
itemsList Numeric Update specifies the identifier of a list containing items to display in the pop-up
objectID Numeric Input specifies the object identifier of the object that received the original _popup method
selection Numeric Output returns the index number of the selection made from the pop-up menu


Details

The _childPopup method is invoked by the _popup method of a child object. The list passed into this method can be modified (such as adding or removing items or making items inactive).

The sequence of events and method calls is

  1. A popmenu event is generated on an object.

  2. The object's _popup method is invoked.

  3. A _super_ in the _popup method invokes the _childPopup method on the owning object or frame. (See _getOwner in this class for more information on owning objects).

  4. If an owning object was found, a _super_ in the owning object's _childPopup method invokes the _childPopup on the frame.

Since the _super_ eventually reaches the frame, the code following the _super_ is where the menu selection should be processed.

After the pop-up menu list is displayed, selection contains the selected menu item. If that selection belongs to this method, the selection should be handled and selection should be set to 0 before returning. The list should also be cleaned up (removing items that were added, adding items that were removed, making items active, and so on). It is important that the list and selection returned from this method be consistent with the list that was passed into the method.


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.