TdxGPImage.Handle Property

Specifies a GDI handle of the stored image.

Declaration

property Handle: GpImage read; write;

Property Value

Type
GpImage

Remarks

Use this property to:

• Access the stored image’s GDI image handle.

• Assign a valid GDI image handle to replace the stored image.

The Handle property returns nil (in Delphi) or nullptr/NULL (in C++Builder) if the image container is empty or suspended. You can use the HandleAllocated property to identify if the Handle property returns a valid GDI image handle.

Note

If the container stores a vector image, the Handle property’s getter converts the image to the BMP format and returns a pointer to the pixel data. Then, you can use the ImageCodec property to restore the original image format.