CONTROL ADD STATUSBAR

<< Click to Display Table of Contents >>

Navigation:  ThinBASIC Modules > UI (User Interface) > CONTROLS > Control Types > StatusBar Control > StatusBar Control Creation >

CONTROL ADD STATUSBAR

 

Description

 

Create a status bar control inside a dialog.

 

Syntax

 

hndl = CONTROL ADD STATUSBAR [Name ControlName], hwnd, ctrlID, txt, xPos, yPos, Width, Height [, [Style] [, [ExStyle]]] [[,] CALL CallBack]

 

Returns

 

Number

Control window handler.

 

Parameters

 

Name

Type

Optional

Meaning

ControlName

String

Yes

Optional name for the control.

 

This name must be globally unique, and is used to create a global variable to be used with control name methods and properties.

hwnd

Number

No

Handle of the dialog containing the control

ctrlID

Number

No

Control identifier

txt

String

No

---Not used--- Leave blank

xPos

Number

No

Horizontal position of the control inside the dialog

yPos

Number

No

Vertical position of the control inside the dialog

Width

Number

No

Control width

Height

Number

No

Control height

Style

Number

Yes

Primary style of the control. See STATUSBAR Style equates.

See Remarks for more info

ExStyle

Number

Yes

Extended style of the control. See STATUSBAR ExStyle equates.

Callback

Function

Yes

Optional name of a Callback Function that receives all %WM_COMMAND and %WM_NOTIFY messages for the control.

 

If a callback for the control is not designated, you must create a dialog Callback Function to process messages from your control.

 

If the Callback Function processes a message, it should return %TRUE (non-zero) to prevent the message being passed unnecessarily to the dialog callback (if one exists). The dialog callback should also return %TRUE if the notification message is processed by that Callback Function.

 

Remarks

 

If no Style will be specified, the following default Style will be used: %WS_CHILD Or %WS_VISIBLE Or %SBARS_SIZEGRIP

 

If Style will not contains %CCS_BOTTOM nor %CCS_TOP, its size will automatically adjusted by UI engine when dialog is resized.

If Style will contains %CCS_BOTTOM or %CCS_TOP, its size will be automatically adjusted only if the dialog events where the statusbar is placed are handled by a callback function.

 

Restrictions

 

See also

 

Examples