Vcl.Graphics.TBitmap.Handle

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property Handle: HBITMAP read GetHandle write SetHandle;

C++

__property HBITMAP Handle = {read=GetHandle, write=SetHandle, nodefault};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property public
Vcl.Graphics.pas
Vcl.Graphics.hpp
Vcl.Graphics TBitmap

Beschreibung

Ermöglicht den Zugriff auf das GDI-Bitmap-Handle von Windows, mit dem auf das GDI-Bitmap-Objekt zugegriffen werden kann.

Mit Hilfe der Eigenschaft Handle wird eine Windows-API-Funktion aufgerufen, die das Handle eines Bitmap-Objekts anfordert. Übergeben Sie Handle als Parameter an diese Funktionen.

Der Wert der Eigenschaft Handle bezeichnet die HBITMAP-Struktur, das vom Bitmap-Objekt gekapselt wird. Ein direkter Zugriff auf das Handle sollte vermieden werden, weil das HBITMAP-Objekt sonst kopiert wird, falls das Handle von mehreren TBitmap-Objekten verwendet wird.

Warnung:  Achten Sie darauf, an welches Objekt oder an welche Routine Sie das Handle übergeben. Wenn der Empfänger der Eigentümer des Bitmap-Handles wird (und es freigibt), müssen Sie TBitmap.ReleaseHandle aufrufen.

Siehe auch

Codebeispiele