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

# TIcon.HandleNeeded

Ensures that handle values for the icon are valid.

## Declaration

Source position: graphics.pp line 1687

`protected procedure TIcon.HandleNeeded; override;`

## Description

Ensures that Handle values are valid for the icon. Configures the values in IconInfo with the BitmapHandle and MaskHandle for the class instance. Calls CreateIconIndirect for the widgetset to get the Handle used for the shared image in the icon.

No actions are performed in the method when the Handle for the shared icon image has already been assigned.

## See also

TIcon.Handle |  | Handle used to access the image data for the icon.
TRasterImage.BitmapHandle |  | BitmapHandle - the Handle that has been allocated for the Bitmap.
TRasterImage.MaskHandle |  | The handle allocated for the Bitmap Mask.
TRasterImage.HandleNeeded |  | Ensures that a handle for the image is allocated in widgetset classes.