Navigation: ABC Library Reference > ToolbarUpdateClass > ToolbarUpdateClass Methods >====== TryTakeToolbar (return toolbar control indicator:ToolbarUpdateClass) ====== | ![]() ![]() |
TryTakeToolbar, VIRTUAL
The **TryTakeToolbar **method returns a value indicating whether the ToolbarTarget object successfully assumed control of the toolbar. A return value of one (1 or True) indicates success; a value of zero (0 or False) indicates failure to take control of the toolbar.
Implementation:
The ToolbarClass.SetTarget method calls the TryTakeToolbar method. The TryTakeToolbar method calls the TakeToolbar and returns True because, by default, a ToolbarUpdateClass object may always assume toolbar control.
**Return Data Type: **BYTE
Example:
ToolbarClass.SetTarget PROCEDURE(SIGNED Id)
I USHORT,AUTO
Hit USHORT
** CODE**
** ASSERT(~ (SELF.List &= NULL))**
** IF Id !set explicitly requested target**
** SELF.List.Id = Id**
** GET(SELF.List,SELF.List.Id)**
** ASSERT (~ERRORCODE())**
** SELF.List.Item.TakeToolbar**
** ELSE !set a valid target**
** LOOP I = 1 TO RECORDS(SELF.List)**
** GET(SELF.List,I)**
** IF SELF.List.Item.TryTakeToolbar() THEN Hit = I.**
** END**
** IF Hit THEN GET(SELF.List,Hit).**
** END**
**See Also: **TakeToolbar, ToolbarClass.SetTarget





