[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'Buttons' (#lcl)

# TButtonGlyph.ExternalImages

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

## Declaration

Source position: buttons.pp line 140

`public property TButtonGlyph.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

TButtonGlyph.ExternalImageIndex |  | Ordinal position for the bitmap in ExternalImages displayed when the button is Up (not pressed).
TButtonGlyph.ExternalPressedImageIndex |  | Ordinal position in ExternalImages for the image displayed when the button is Pressed (down).
TButtonGlyph.ExternalDisabledImageIndex |  | Ordinal position in ExternalImages for the image displayed when the button is Disabled.
TButtonGlyph.ExternalHotImageIndex |  | Ordinal position in ExternalImages for the image displayed when the button is Hot (hovered).
TButtonGlyph.ExternalSelectedImageIndex |  | Ordinal position in ExternalImages for the image displayed when the button is Selected (has focus).
TButtonGlyph.ExternalImageWidth |  | Width for the images in the ExternalImages property.
TButtonGlyph.GetImageIndexAndEffect |  | Gets the index for a button image using a given state, and the effect used to draw it.
TButtonGlyph.Images |  | The list of available images for the button glyph.
TButtonGlyph.Glyph |  | The bitmap image drawn as the glyph on the button.
TButtonGlyph.NumGlyphs |  | The number of glyphs available for button states.
TButtonGlyph.GlyphChanged |  | Provides a default implementation for the OnChange event handler.
TButtonGlyph.CanShowGlyph |  | Determines if an image is available for the button glyph.