Vcl.Graphics.TMetafileCanvas.Create

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

constructor Create(AMetafile: TMetafile; ReferenceDevice: HDC);

C++

__fastcall TMetafileCanvas(TMetafile* AMetafile, HDC ReferenceDevice);
__fastcall TMetafileCanvas(TMetafile* AMetafile, HDC ReferenceDevice, const System::UnicodeString CreatedBy, const System::UnicodeString Description);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
constructor public
Vcl.Graphics.pas
Vcl.Graphics.hpp
Vcl.Graphics TMetafileCanvas

Beschreibung

Erzeugt eine Instanz von TMetafileCanvas und fordert ein Handle auf einen Metadatei-Gerätekontext an.

Mit Create wird ein TMetafileCanvas-Objekt erzeugt und instantiiert. Die zugehörige Metadatei, deren Bild gerade gezeichnet wird, wird im Parameter AMetafile übergeben. Im Parameter ReferenceDevice wird ein Handle auf einen Gerätekontext übergeben, auf dem der Gerätekontext der Metadatei basieren soll. Dies ist meistens ein Gerätekontext für ein Fenster, in dem das Bild gezeichnet wird.

Die Größe des TMetafile-Objekts wird vom Parameter ReferenceDevice übernommen, sofern die Eigenschaften MMHeight und MMWidth nicht bereits gesetzt sind. Anschließend erzeugt Create einen Metadatei-Gerätekontext und setzt die Eigenschaft Handle entsprechend. Alle nachfolgenden Zeichenmethoden richten ihre Ausgabe dann an diesen Metadatei-Gerätekontext.

Wenn TMetafileCanvas freigegeben wird, werden mit den Strings aus CreatedBy und Description die gleichnamigen Eigenschaften im TMetafile-Objekt gesetzt.

Siehe auch

Codebeispiele