Toolbar properties

Toolbars have two sets of properties - dynamic and static.

Dynamic properties can be changed while the toolbar is running. Position - move the toolbar (right-drag). Size - resize the toolbar (drag an edge). Some other properties can be changed in the right-click menu. Dynamic properties are automatically saved in current main QM file.

Static properties can be changed in the Properties dialog. They are saved in toolbar text, first line, and also can be edited directly there. They are described below. If toolbar position, size or right-click menu settings are specified, the specified static properties are used instead of the automatically saved dynamic properties.

Syntax

 /option1 [parameters] [/option2 [parameters] ...]

 /col 0x80C0FF /hcol "" 0xFF /style WS_CAPTION|WS_SYSMENU|WS_MINIMIZEBOX 0

 /mov 200 {ret GetClientTop(val(_command))-20}
 /mov 200 TB_ClientY-20

Available options

1. Set toolbar position.

 /mov x y

Here x and y are toolbar position, in pixels. If the parameters are (or begin with) xm and ym, toolbar will be under the mouse pointer. Coordinates are relative to the owner window or screen top-left or other corner (depends on the Coordinates setting; see also /client). Use mov0 to apply only first time.

Examples:

 /mov 200 0
 /mov xm ym+100
 /mov 200 -23 /client

2. Set toolbar dimensions.

 /siz width height

Use siz0 to apply only first time.

3. Set toolbar dimensions for shrinked state.

 /ssiz width height

Use ssiz0 to apply only first time.

4. Set icon size.

 /isiz width height

Default size is 16x16. If cy is omitted, it will be equal to cx. If cx is more than cy, text is placed below icon.

5. Set maximum and/or minimum button size.

 /bsiz maxwidth minwidth

QM 2.2.1: Works with all styles. Added minwidth.

6. Set initial settings of the right-click menu. In the Properties dialog it is "Style flags".

 /set flags mask

Example:

 /set 1|2|8|0x400

Use set0 to apply only first time.

7. Set toolbar window style and extended style.

 /style st exst

Here st and exst are style and extended style of the toolbar window. Can be used style constant names, like in the example. Reference - MSDN.

Example:

 /style (WS_CAPTION | WS_SYSMENU)

8. Set background and text color.

 /col color textcolor

Here color and textcolor are colors in 0xBBGGRR format. Value 1 to 31 will set one of system colors.

9. Set hot item background and text color.

 /hcol color textcolor

If you set hot item background color, Windows themes (visual styles) are not applied, and the toolbar may look differently.

Does not work when 3D buttons.

10. Set transparency.

 /transp opacity color

On Vista and later, hot button may look distorted. It is because its color is gradient, and some lines match the transparent color and therefore are transparent. Try to change background color with /col.

11. Set background image. Can be bmp, gif, jpg. QM 2.3.4: also can be png.

 /bmp "file"

Example:

 /bmp "$my qm$\images	b1.bmp"

12. Glass. QM 2.2.0.

 /glass

Translucent toolbar. Incompatible with /bmp, transparent color and hot color (these are ignored if /glass is used). Does not work on Windows XP or if Windows Aero theme is disabled.

13. Set font. QM 2.2.0.

 /font XXXX

Font can be set in Properties.

On Vista and later, does not work when 3D buttons.

14. Lock toolbar.

 /lock flags

If flags is not used, are applied all flags except 128.

15. Toolbar position specified in mov/mov0 is relative to the client area of the owner window, or to the work area if no owner. QM 2.4.3.

 /client

16. Set hook function.