Toolbar properties

Toolbar position, size and some other properties can be easily set by moving, resizing the toolbar, and using the right-click menu. They are saved in the registry. Other properties can be set in the Properties dialog. They are placed in the first line of toolbar text, so you can also edit them directly. They are applied when launching the toolbar.

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

Line begins with space or semicolon. It can contain one or more options. Each option begins with /. Most options have one or two parameters. If some parameter is not used, it can be omitted (if it is the last parameter), or can be "". Numeric parameters can be simple integer values (digits), named constants, global variables, user-defined functions without arguments, and expressions with operators. An expression with operators must be enclosed in parentheses, unless it don't contain spaces and /. Expressions with operators are evaluated from left to right, regardless of operator priority.

Example (first line of toolbar text):

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

A numeric parameter also can be code, enclosed in { }. The code is executed as function, when creating the toolbar. It runs in the QM main thread. The handle of the owner window is stored into the _command variable. Don't forget to return a value (ret). Alternatively, numeric parameters can include user-defined functions without arguments.

Examples:

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

Use mov0, siz0, ssiz0 and set0 to apply these options only first time and after Reset.

Available options

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). Use mov0 to apply only first time.

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.

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

You can optionally use mask to apply only some flags. Will be applied only those bits of flags that are 1 in mask. Other bits will be retrieved from the registry. First time (if toolbar settings are not found in the registry) are applied all flags regardless of mask.

Here st and exst are style and extended style of the toolbar window. Window styles are defined in the WinStyles function in the System\Declarations folder.

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

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

opacity - value between 0 (makes the toolbar completely transparent) and 255 (completely opaque).

color - sets the specified color completely transparent. Completely transparent areas are transparent to the mouse too. Optional.

On Vista, 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.

On Windows Vista, the toolbar will be translucent, like title bars of windows. Has no effect on older Windows versions, or if not supported by hardware or software (e.g. on Vista Home edition, or Aero theme is not used). Incompatible with /bmp, transparent color and hot color (these are ignored if /glass is used).

flags - combination of the following values. If flags is not used, are applied all flags except 128.

15. You can specify an ini file where toolbar size, position and right-click menu settings must be stored. By default, these settings are stored in the registry.

1	Follow owner.
2	Show text.
4	Activate owner.
8	Auto shrink.
16	Equal buttons.
32	No sizing border.
64	Tooltips always.
128	Vertical.
0x000	Coordinates: top-left.
0x100	Coordinates: top-right.
0x200	Coordinates: bottom-left.
0x300	Coordinates: bottom-right.
0x400	Coordinates: auto select.
0x1000	All desktops.
0x2000	Quick icons.
0x4000 (QM 2.2.0)	1-pixel border.
0x8000 (QM 2.2.1)	3D buttons.

1	don't show the right-click menu.
2	disable moving.
4	disable resizing.
8	disable modifying. This disables drag&drop features, and three first items in the right-click menu. Even if this option is not used, toolbar cannot be modified if it is encrypted, or is in read-only folder or file, or is in locked file.
16	disable the Close item in the right-click menu.
128	lock only if the toolbar is in a shared file ([s] folder).