Navigation: ABC Library Reference > ToolbarUpdateClass > ToolbarUpdateClass Methods >====== TakeEvent (convert toolbar events:ToolbarUpdateClass) ====== | |
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