[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.


Version 4.0 Generated 2025-05-03 Home