PageSaveAsMetafile¶
PageSaveAsMetafile erzeugt von der angegebenen Seite eine Windows-Meta-Datei (WMF), eine Enhanced Metafile-Datei (EMF), eine Enhanced Metafile with Extensions (EMF+) oder eine Kombination aus EMF und EMF+ (EMF+Dual).
-
bool = PageSaveAsMetafile(hPage, ssFileName)
-
bool = PageSaveAsMetafile(hPage, ssFileName, rsScale)
-
bool = PageSaveAsMetafile(hPage, ssFileName, rsScale, nEMF)
-
bool = PageSaveAsMetafile(hPage, ssFileName, rsScale, nEMF, bSetViewPort)
-
bool = PageSaveAsMetafile(hPage, ssFileName, rsScale, nEMF, bSetViewPort, nClipFlag)
Returnwert
bool ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).
Parameter
-
hPage
hPage ist die Zugriffsnummer (Handle) der Seite.
-
ssFileName
ssFileName ist der vollständige Dateiname unter der die Datei gespeichert werden soll.
-
rsScale
rsScale ist ein Faktor um das Meta-Bild-Größe zu skalieren. Der Faktor muss im Bereich 0.1 bis 3.0 (
1% - 300%
) liegen. Wird der Parameter nicht angegeben, wird der Wert 1 verwendet.
-
nEMF
Gibt den Typ der Metadatei an.
Wert Beschreibung 0 WMF (Default) (Namenserweiterung .wmf
).1 EMF (Namenserweiterung .emf
).2 EMF+ (Namenserweiterung .emf
).3 EMF+Dual (Namenserweiterung .emf
).
-
bSetViewPort
Wenn bSetViewPort gleich TRUE ist, wird bei WMF-Dateien der Viewport gesetzt. Auf EMF-Dateien hat dieser Parameter keinen Einfluss. Defaultwert ist TRUE (1). Einige Programme können keine Metafiles verwenden, wenn der Viewport in der Metadatei gesetzt wurde. Dann sollte dieser Parameter auf FALSE (0) gesetzt werden.
-
nClipFlag
Legt fest, wie die Größe der Seite berechnet wird.
Wert Beschreibung 0 Boundig Box: Größtes Rechteck, das alle Elemente der Seite umschließt. (Default Wert) 1 Boundig Box: Größtes Rechteck. Das Rechteck wird an den Seitengrenzen abgeschnitten. 2 Seitengröße.
History
Version | Beschreibung |
---|---|
R2018 | Der vierte Parameter nEMF kann nun die Werte 0 bis 3 annehmen. |
R2017 | |
5.30.9 | Neuer Parameter nClipFlag |
id-533873