User Tools

Site Tools


trytaketoolbar_return_toolbar_control_indicator_toolbarupdateclass_.htm
Navigation:  ABC Library Reference > ToolbarUpdateClass > ToolbarUpdateClass Methods >====== TryTakeToolbar (return toolbar control indicator:ToolbarUpdateClass) C6H0009.jpg ====== Previous pageReturn to chapter overviewNext page

TryTakeToolbar, VIRTUAL

blk2blue.jpg

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

trytaketoolbar_return_toolbar_control_indicator_toolbarupdateclass_.htm.txt · Last modified: by 127.0.0.1