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

TButtonGlyph.ExternalImages

Contains a reference to an existing list of images available for use in the Glyph property.

Declaration

Source position: buttons.pp line 136

public property TButtonGlyph.ExternalImages : TCustomImageList
  read FExternalImages
  write SetExternalImages;

Description

ExternalImages is a TCustomImageList property with a list of images that can be used to set the glyph for the class instance.

TButtonGlyph can use images that originate from one of several properties: Images, ExternalImages, or Glyph. Images is a cached imaged list which may be refreshed when the cached images are changed. ExternalImages is an image list explicitly assigned to the property which does not use the image cache. Glyph is the bitmap to use for the glyph, and can originate from an LCL resource.

These image sources are used in the GetImageIndexAndEffect method to determine the image resolution and bitmap used for the glyph and the button state.

Setting a new value for the property causes the Glyph property to be cleared, and the OnChange event handler is signalled.

Setting a value for the Glyph or LCLGlyphName properties causes the image list in ExternalImages to be discarded.

Use ExternalImageWidth to specify the width of the images in ExternalImages.

Use ExternalImageIndex to specify the position in ExternalImages for the bitmap displayed as the button glyph.

See also

TButtonGlyph.ExternalImageIndex

  

Ordinal position in the external image list for the glyph image.

TButtonGlyph.ExternalImageWidth

  

Width of an image in the external image list.

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.