AddToolbarTarget (set the browse toolbar)

Top  Previous  Next

 

AddToolbarTarget( toolbar )

AddToolbarTarget

Registers the browse list as a potential target of the specified toolbar.

Toolbar

The label of the ToolbarClass object that directs toolbar events to this BrowseClass object.

The AddToolbarTarget method registers the BrowseClass object as a potential target of the specified toolbar.

The ToolbarClass.SetTarget method sets the active target for a ToolbarClass object.

Implementation:

The Toolbar object for a browse is the object that detects toolbar events, such as scroll down or page down, and passes them on to the active ToolbarTarget object. In the standard template implementation, there is a single global toolbar, and a Toolbar object per procedure that may drive several different browses and forms, each of which is a ToolbarTarget. Only one ToolbarTarget is active at a time.

Example:

!tie BrowseSt object to Toolbar object

BrowseSt.AddToolbarTarget(Browse:Toolbar)

!tie BrowseZIP object to Toolbar object

BrowseZIP.AddToolbarTarget(Browse:Toolbar)

!program code

Browse:Toolbar.SetTarget(?StList)  !state list is current toolbar target

!program code

Browse:Toolbar.SetTarget(?ZIPList) !ZIP list is current toolbar target

See Also:     Toolbar, ToolbarItem, ToolbarClass.SetTarget