Vcl.Controls.TControlCanvas.FreeHandle
Delphi
procedure FreeHandle;
C++
void __fastcall FreeHandle(void);
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
procedure function |
public | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | TControlCanvas |
Description
Releases the handle to a device context (HDC) used by the control canvas object.
Call FreeHandle to free the HDC used by the control canvas. FreeHandle sets the Handle property to NULL. After calling FreeHandle, an HDC will be reacquired if any of the drawing methods are called.
Note: Setting the Handle property to NULL does not free the HDC. Set the Handle property to NULL rather than call FreeHandle if the HDC is released by the application.