Navigation:  thinBasic Modules > UI (User Interface) > Dedicated Control Functions > ToolBar Control >

ToolBar_AddButton

Previous pageReturn to chapter overviewNext page

 

Description

 

Add a button to a ToolBar.

 

Syntax

 

n = ToolBar_AddButton(hWnd, ctrlID, Image, cmd, Style, Text [, AT Item])

 

Returns

 

Number

 

Parameters

 

Name

Type

Optional

Meaning

hWnd

Number

No

Handle of the dialog containing the control

ctrlID

Number

No

Control identifier assigned to the control during CONTROL ADD ...

Image

Number

No

Image number selected (1=first, 2=second, etc.)

Cmd

Number

No

Command id number associated with this button.

Style

Number

No

Style descriptor bits for this button.

%TBSTYLE_BUTTONThe button behaves like a standard push button.
%TBSTYLE_CHECKThe button is dual-state which toggles between the pressed and non-pressed state each time it's clicked.
%TBSTYLE_GROUPDefines a group of buttons.  When combined with the check style, it creates a button that stays pressed until another button in the group is pressed. This is similar to an option button or radio button.
%TBSTYLE_CHECKGROUPA combination of check and group styles.

Test

String

No

A text string to be displayed on this button.

Item

Number

Yes

If the optional "AT item&" clause is included, the button is inserted at the designated position (1=first, 2=second, etc.).  Otherwise, it is added to the end of the list.

 

Remarks

 

Restrictions

 

See also

 

Examples