Sign in Join
FPDoc Onlineexperiment

TButtonGlyph.ExternalImages property

Member of TButtonGlyphpublicIn unit Buttons

Contains a reference to an external list of images that can be used as the Glyph image,

Declaration

pascal
property ExternalImages: TCustomImageList read FExternalImages write SetExternalImages;

Description

ExternalImages is a TCustomImageList property with the list of images that can be displayed as a glyph for the class instance. ExternalImages represents an image list assigned to the Images property for a button control, like TBitBtn or TSpeedButton. The image list contains bitmaps displayed for the various states for an associated button; i. e. Up, Pressed, Hot, Disabled, or Selected. The image used for a given button state is indicated in the properties: ExternalImageIndex, ExternalHotImageIndex, ExternalDisabledImageIndex, ExternalPressedImageIndex, and ExternalSelectedImageIndex.

Values in ExternalImages are used when a glyph bitmap has not been allocated in the Glyph property. Setting a new value for ExternalImages causes the Glyph property to be cleared, and the OnChange event handler is signalled. Conversely, setting a value for the LCLGlyphName property causes the reference in ExternalImages to be discarded.

Bitmaps in ExternalImages (or Glyph) are stored in the Images property, and used in the GetImageIndexAndEffect method to determine the image resolution and bitmap used for the glyph and the button state.

Use ExternalImageWidth to specify the Width of the images in the ExternalImages container.

See also

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