TakeEvent (convert toolbar events:ToolbarUpdateClass)


Top  Previous  Next

 

TakeEvent( [ vcr ], window manager ), VIRTUAL

TakeEvent

Handles toolbar events for the ToolbarUpdateClass object.

Vcr

An integer variable to receive the control number of the accepted VCR navigation button. This lets the TakeEvent method specify an appropriate subsequent action. If omitted, the ToolbarUpdateClass object does no "post processing" navigation.

windowmanager

The label of the ToolbarUpdateClass object's WindowManager object. See Window Manager for more information.

The TakeEvent method handles toolbar events for the ToolbarUpdateClass object.

The vcr parameter lets the TakeEvent method specify an appropriate subsequent or secondary action. For example, the ToolbarUpdateClass.TakeEvent method (for a FORM), may interpret a vcr scroll down as "save and then scroll." The method takes the necessary action to save the item and accomplishes the secondary scroll action by setting the vcr parameter.

Implementation:

The ToolbarClass.TakeEvent method calls the TakeEvent method for the active ToolbarTarget object. The ToolbarClass.SetTarget method sets the active ToolbarTarget object.

Example:

ToolbarClass.TakeEvent PROCEDURE(<*LONG VCR>,WindowManager WM)

 CODE

ASSERT(~SELF.List &= NULL)

IF RECORDS(SELF.List)

 SELF.List.Item.TakeEvent(VCR,WM)

END

See Also:     ToolbarClass.SetTarget, ToolbarClass.TakeEvent