CONTROL ADD STATUSBAR

Description

Create a status bar control inside a dialog.

Syntax

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

Returns

Number

Control window handler.

Parameters

Name	Type	Optional	Meaning
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