RenderPageToMetafileStream
Rendering und Drucken
Beschreibung
Diese Funktion ist nur in der Delphi-Edition verfügbar. Sie rendert eine Seite aus dem ausgewählten Dokument in einen TStream als Windows-Metadatei (Vektorausgabe), wobei der Text und Vektorinhalt der Seite erhalten bleibt, anstatt sie in Pixel zu rastern
Das gewählte Format steuert die Metadatei-Variante: mfEMF verwendet den klassischen GDI-Enhanced-Metafile-Pfad (breite Verbraucherkompatibilität), mfEMFPlus und mfEMFDual verwenden den GDI+-Aufzeichnungspfad (bessere Treue für Transparenz und Kantenglättung) und mfWMF erzeugt das veraltete 16-Bit-Format
mfEMFDual zeichnet sowohl GDI- als auch GDI+-Befehle in derselben Datei auf, sodass ältere reine GDI-Anwendungen sie auf Kosten einer größeren Dateigröße weiterhin lesen können. Bevorzugen Sie mfEMFPlus, wenn Sie wissen, dass der Empfänger GDI+-fähig ist (Office, Illustrator, moderne Viewer)
Intern ist dies ein praktischer Wrapper um RenderPageToStream, der das Format auf einen Ganzzahlwert für Options abbildet, sodass DPI weiterhin mit dem über SetRenderScale festgelegten instanzspezifischen RenderScale multipliziert wird
Syntax
Delphi
Function TPDFlib.RenderPageToMetafileStream(DPI: Double; Page: Integer; Format: TPDFlibMetafileFormat; Target: TStream): Integer;Parameter
| DPI | Die bei der Skalierung der Seite zu verwendende DPI. Steuert die Dimensionen des Metadatei-Rahmens; Vektorinhalte selbst sind DPI-unabhängig |
|---|---|
| Page | Die zu rendernde Seitennummer |
| Format | mfEMF = klassisches GDI-EMF; mfEMFPlus = GDI+ EMF+ Only; mfEMFDual = GDI+ EMF+ Dual (GDI + GDI+-Aufzeichnungen, größer, aber weitgehend kompatibel); mfWMF = veraltetes 16-Bit-WMF |
| Target | Der Stream, in den die gerenderten Metadatei-Bytes geschrieben werden sollen |
Rückgabewerte
| 0 | Die Seite konnte nicht gerendert werden |
|---|---|
| 1 | Die Seite wurde korrekt gerendert und die Metadatei-Bytes wurden in den Stream geschrieben |