Home > BSPrinter documentation > Reference

ToolbarButtonPicture Property

Applies to: PrintPreview control , IPrinterEx object

Type: Picture

Additional parameter(s):
In          Required          ToolbarIconIdentifier          As BSToolbarIconIdentifierConstants
In          Required          SizeIdentifier          As BSIconImageSizeIdentifierConstants


Returns or sets the images that will be used as the toolbar icons in the Print Preview dialog box.
They can be bitmap or icon format.
In case of bitmaps, the color for transparency is &HFF00FF or if this color is not present, the first pixel (at 0,0 position) will be used as the transparent color.

The SizeIdentifier parameter identifies the size that is being set or retrieved.
When changed, normally all 5 images need to be supplied, one at a time.

Note: why 5 sizes of icons? The toolbar buttons have the options of three sizes: small, medium and big (see ToolbarIconsSize).
In addition to that, if the client program is manifested as DPI aware, the component automatically handles the icon sizes for each DPI setting. It handles these two features with 5 different icon sizes: 20x20 pixels, 24x24 pixels, 30x30 pixels, 36x36 pixels and 44x44 pixels.

If the client program is not DPI aware, only the 20x20 pixels, 24x24 pixels and 30x30 pixels images are needed.
If ToolbarIconsSize is set to a setting where the user can't change the size of the toolbar buttons, but the program is manifested as DPI aware, only three will be used (depending on the size if the toolbar buttons, small, medium or big, they can be 20x20/24x24/30x30 for small, 24x24/30x30/36x36 for medium or 30x30/36x36/44x44 for big.
And if the program is not DPI aware and ToolbarIconsSize is set to a setting where the user can't change the toolbar buttons size, only one will be used. (20x20 for small icons, 24x24 for medium or 30x30 for big).

See Also:

ToolbarIconsSize property