Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxGPImage.Handle Property

Specifies a GDI handle of the stored image.

#Declaration

Delphi
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.

See Also