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