Vcl.Graphics.TCanvas.Handle

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Handle: HDC read GetHandle write SetHandle;

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
property public
Vcl.Graphics.pas
Vcl.Graphics.hpp
Vcl.Graphics TCanvas

Description

Spécifie le handle de ce canevas.

La propriété Handle spécifie le handle GDI Windows du contexte de périphérique de ce canevas.

Affectez à Handle le HDC du contexte de périphérique dans lequel le canevas doit dessiner. Quand un contrôle fenêtré répond à un message de dessin Windows, le HDC de dessin est retransmis à la méthode PaintWindow. Dans les autres cas, il est possible d'obtenir un HDC pour une fenêtre en appelant la méthode GetDeviceContext d'un contrôle. De plus, Windows dispose de fonctions de l'API pour obtenir le HDC d'une imprimante ou d'une image mémoire.

Consultez la propriété Handle pour aller au-delà des possibilités de dessin offertes par l'objet TCanvas, en utilisant des appels de fonction de l'API qui nécessitent un handle de contexte de périphérique. La plupart des appels de fonctions GDI Windows attendent un paramètre HDC.

TCanvas ne possède pas le HDC. Les applications doivent créer un HDC et l'affecter à la propriété Handle. Les applications doivent libérer le HDC quand le canevas n'en a plus besoin. L'affectation de la propriété Handle d'un canevas ayant déjà un HDC valide ne libère pas automatiquement le HDC préexistant.

Remarque :  Certains descendants de TCanvas, comme TControlCanvas, possèdent le HDC. N'affectez pas la propriété Handle de ces objets. Ils obtiennent et libèrent leur propre Handle.

Voir aussi