TRasterImage.SetHandle procedure

Declaration

procedure SetHandle(AValue: TLCLHandle); virtual

Arguments

Description

SetHandle stores the specified TLCLHandle value as the handle used for the image. The handle is actually the one used by the internal TSharedRasterImage instance for the class. No actions are performed in the method when the value in AHandle is the same as the handle in the shared image instance.

SetHandle frees the device context for the bitmap Canvas, unshares the shared image, and discards its image data. The handle in AValue is assigned to the internal shared image. When no other active update processes are pending, the Changed method is called.

Modified in LCL version 4.0 to use the TLCLHandle type instead of the deprecated THandle type in the AValue parameter.

See also

• Changed
• Canvas
• BeginUpdate
• EndUpdate
• SetHandles
• Reference
• LCLType.TLCLHandle
• WSReferences.TLCLHandle