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

---Ignored---

xPos

Number

No

---Ignored---

yPos

Number

No

---Ignored---

Width

Number

No

---Ignored---

Height

Number

No

---Ignored---

Style

Number

Yes

Optional primary style of the ToolBar control.  The default ToolBar style is %WS_CHILD or %WS_VISIBLE or %WS_BORDER or %CCS_TOP or %TBSTYLE_FLAT.

ExStyle

Number

Yes

Extended style of the ToolBar control.  The extended ToolBar style  value can be a combination of the values below, combined together with  the OR operator to form a bitmask:

CallBack

Function

Yes

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

ToolBar command messages result from clicking a ToolBar Button, so the message is sent to the callback specified in TOOLBAR_ADDBUTTON or the dialog callback specified in.

Message routing by button allows you to easily determine which button generated the event, and eliminates virtually all %WM_COMMAND messages here.  This callback is primarily used to process %WM_NOTIFY messages.

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.