Sign in Join
FPDoc Onlineexperiment

TToolBar.Images property

Member of TToolBarpublishedIn unit ComCtrls

List with images displayed when a tool button is enabled.

Declaration

pascal
property Images: TCustomImageList read FImages write SetImages;

Description

Images is a TCustomImageList property with icon images displayed on tool buttons when they are enabled. Use DisabledImages for the images displayed when the tool button are not enabled. Use HotImages for the images displayed when tool buttons are enabled and hovered under the mouse cursor.

The image position for a tool button is stored in the ImageIndex property in the TToolButton instance.This requires the image at a given position in the image lists to target the same button on the tool bar control.

The image list should contain images which uses the sames width and height, and appropriately sized for the ButtonWidth and ButtonHeight for the tool bar. Use ImagesWidth to specify the size needed for tool button icons independent of the actual image size stored in the image lists.

When a new image list is assigned to the property, the tool bar is redrawn.

The image lists are used when the tool buttons get the current icon drawn in the Paint method.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.