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

TCustomImageList.Scaled

Indicates if images are automatically scaled for missing resolutions.

Declaration

Source position: imglist.pp line 417

public property TCustomImageList.Scaled : Boolean
  read FScaled
  write FScaled
  default False;

Description

Scaled is a Boolean property that indicates if images are automatically scaled for missing resolutions requested in the image list. The default value for the property is False.

When Scaled contains True, images in the list are dynamically scaled to the required width for a given display density (PPI). If the resolution already exists in the image list, it is used to retrieve images. If it does not already exist, an existing resolution is used as the basis for scaling images to the required width. When Scaled contains False, dynamic scaling is not performed for image resolutions. Instead, the closest resolution that matches the desired width is used as the source for images.

Use the OnGetWidthForPPI event handler to perform image size overrides or substitution for a given display density (PPI).

Scaled is used in the implementation of the GetResolutionForPPI and GetWidthForPPI methods.

See also

TCustomImageList.ResolutionForPPI

  

Gets a scaled resolution with the specified width, display density, and scaling factor.

TCustomImageList.WidthForPPI

  

Image width needed for the specified display density.

TCustomImageList.OnGetWidthForPPI

  

Event handler used to override the scaled width for a display density.

TCustomImageList.FindResolution

  

Finds the image resolution which uses the specified image width.

TCustomImageList.Resolution

  

Provides indexed access to an image resolution with the specified image width.

TCustomImageList.Resolutions

  

Provides access to the image resolutions (or sizes) used in the image lists.

The latest version of this document can be found at lazarus-ccr.sourceforge.net.