Vcl.Graphics.TBitmap.Dormant

• Up to Parent: TBitmap

Delphi

procedure Dormant;

C++

void __fastcall Dormant();

Properties

Type	Visibility	Source	Unit	Parent
procedure function	public	Vcl.Graphics.pas Vcl.Graphics.hpp	Vcl.Graphics	TBitmap

Description

Creates a memory bitmap image in order to release the bitmap handle, forcing the image into DIB format to save resources.

Use Dormant to change the format of the bitmap in memory thereby reducing the amount of GDI resources used by the application.

Dormant creates a bitmap image in memory using a memory stream object. This preserves the image so that the bitmap can then free the HBITMAP (accessed through the Handle property) that was assigned to it.

DIB handles may use fewer Win95 GDI resources than DDB, but DIBs may also use more memory than DDBs, depending on the current video driver and mode.

See Also

• Handle

• TBitmapImage

• TMemoryStream

Code Examples

• LoadFromFile (Delphi)
• LoadFromFile (C++)