TdxCustomSmartImage.Dormant Method

Releases the handle associated with the stored image data.

Declaration

procedure Dormant;

Remarks

This procedure works similarly to the Dormant procedure provided by the TBitmap class. The Dormant procedure is particularly helpful if you need to manage multiple Smart Image objects in order to reduce the amount of GDI resources used by your application.

Call the Dormant procedure to save the stored image data into a temporary buffer and release the image’s handle. To restore the suspended Smart Image object, call the HandleNeeded procedure.

If the HandleAllocated property returns False, calling the Dormant procedure has no effect.