Navigation:  ThinBASIC Modules > UI (User Interface) > Additional Controls and Functions > ToolBar Control >

ToolBar_SetState

Previous pageReturn to chapter overviewNext page

 

Description

 

Sets the state descriptor bits for a specific button in a ToolBar.

 

Syntax

 

n = ToolBar_SetState(hWnd, ctrlID, [BYCMD] item, lState)

 

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 ...

item

Number

No

The position number of button to be checked.

If BYCMD is specified, the command value is used to identify the button

lState

Number


The state descriptor bits may consist of one or more of the number of buttons (and separators) currently present on the ToolBar.

%TBSTATE_DISABLED                The button is disabled and grayed. (value=0)

%TBSTATE_CHECKED                The button is checked.

%TBSTATE_PRESSED                The button is pressed.

%TBSTATE_ENABLED                The button is enabled.

%TBSTATE_HIDDEN                The button is hidden.

%TBSTATE_INDETERMINATE        The button is indeterminate and grayed.

%TBSTATE_MARKED                The button is highlighted.

 

Attention: this is a bit state so use OR to set more than one state.

 

Remarks

 

Restrictions

 

See also

 

Examples

 

ToolBar_SetState( hDlg, %tToolbar, 2, %TBSTATE_ENABLED Or %TBSTATE_CHECKED)