Vcl.Controls.TControlCanvas.FreeHandle

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure FreeHandle;

C++

void __fastcall FreeHandle();

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
Vcl.Controls.pas
Vcl.Controls.hpp
Vcl.Controls TControlCanvas

Beschreibung

Gibt das Handle auf den Gerätekontext (HDC) frei, der von dem Zeichenflächenobjekt verwendet wird.

Durch einen Aufruf von FreeHandle geben Sie den HDC frei, den die Steuerelement-Zeichenfläche verwendet. FreeHandle setzt die Eigenschaft Handle auf NULL. Nach dem Aufruf von FreeHandle wird ein neuer HDC angefordert, sobald eine Zeichenmethode aufgerufen wird.

Anmerkung:  Das Setzen der Handle-Eigenschaft auf NULL führt nicht zur Freigabe des HDC. Wenn der HDC von der Anwendung freigegeben wird, rufen Sie nicht FreeHandle auf, sondern setzen die Eigenschaft Handle auf NULL.

Siehe auch