Vcl.Graphics.TCanvas.Handle
Delphi
property Handle: HDC read GetHandle write SetHandle;
C++
__property HDC Handle = {read=GetHandle, write=SetHandle, nodefault};
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
property | public | Vcl.Graphics.pas Vcl.Graphics.hpp |
Vcl.Graphics | TCanvas |
Beschreibung
Legt das Handle für die Zeichenfläche fest.
Die Eigenschaft Handle gibt das Windows-GDI-Handle des Gerätekontextes für diese Zeichenfläche an.
Setzen Sie Handle auf das HDC für den Gerätekontext, in dem die Zeichenfläche gezeichnet werden soll. Wenn ein Steuerelement auf eine Paint-Botschaft von Windows reagiert, wird das HDC an die Methode PaintWindow übergeben. Andernfalls kann das HDC eines Fensters ermittelt werden, indem die Methode GetDeviceContext eines Steuerelements aufgerufen wird. Außerdem stellt Windows API-Aufrufe zur Verfügung, um ein HDC für einen Drucker oder ein gespeichertes Bild zu ermitteln.
Durch einen Lesezugriff auf die Eigenschaft Handle können Sie die im TCanvas-Objekt verfügbaren Zeichenfunktionen um API-Aufrufe ergänzen, die ein Handle für einen Gerätekontext erfordern. Fast alle Funktionen der Windows-GDI erwarten, dass ihnen ein HDC übergeben wird.
TCanvas ist nicht der Eigentümer des HDC. Das HDC muss von der Anwendung erzeugt und die Eigenschaft Handle explizit gesetzt werden. Außerdem muss das HDC von der Anwendung freigegeben werden, wenn es von der Zeichenfläche nicht mehr benötigt wird. Das Setzen der Eigenschaft Handle einer Zeichenfläche, die bereits über ein gültiges HDC verfügt, gibt das ursprüngliche HDC nicht automatisch frei.
Anmerkung: Einige Nachkommen von TCanvas wie z.B. TControlCanvas sind Eigentümer des HDC. Bei diesen Objekten sollte die Eigenschaft Handle nicht gesetzt werden. Sie holen sich ihr Handle selbst und geben es auch selbst wieder frei.
Siehe auch
Codebeispiele