GdiPlayPageEMF-Funktion (winppi.h)

  • Artikel

Die GdiPlayPageEMF-Funktion gibt die EMF-Datensätze innerhalb eines angegebenen Rechtecks für eine Dokumentseite eines Spooldruckauftrags wieder.

Syntax

BOOL GdiPlayPageEMF(
  HANDLE SpoolFileHandle,
  HANDLE hemf,
  RECT   *prectDocument,
  RECT   *prectBorder,
  RECT   *prectClip
);

Parameter

SpoolFileHandle

Vom Aufrufer bereitgestelltes Spooldateihandle, das durch einen vorherigen Aufruf von GdiGetSpoolFileHandle abgerufen wurde.

hemf

Vom Aufrufer bereitgestelltes Seitenhandle, das durch Aufrufen von GdiGetPageHandle abgerufen wird und die Seite identifiziert, für die Datensätze wiedergegeben werden sollen.

prectDocument

Vom Aufrufer bereitgestellter Zeiger auf eine RECT-Struktur , die das Rechteck angibt, in das die Seite gezeichnet werden soll.

prectBorder

Vom Aufrufer bereitgestellter Zeiger auf eine RECT-Struktur, die das Rahmenrechteck der Seite angibt (falls vorhanden). Kann NULL sein.

prectClip

Vom Aufrufer bereitgestellter Zeiger auf eine RECT-Struktur, die die Koordinaten des Clipbereichs der Seite angibt (falls vorhanden). Kann NULL sein.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion TRUE zurück. Andernfalls gibt die Funktion FALSE zurück, und ein Fehlercode kann durch Aufrufen von GetLastError abgerufen werden.

Hinweise

Die GdiPlayPageEMF-Funktion wird von gdi32.dll zur Verwendung in der PrintDocumentOnPrintProcessor-Funktion eines Druckprozessors exportiert.

Die GdiPlayPageEMF-Funktion ist das Mittel, mit dem ein Druckprozessor eine Dokumentseite oder einen angegebenen rechteckigen Bereich einer Dokumentseite auf einer physischen Seite positioniert. Beachten Sie, dass GdiPlayPageEMF nicht tatsächlich im Gerätekontext druckt, sondern stattdessen eine Datenstruktur vorbereitet, die den Text und die Grafiken beschreibt, die auf den physischen Seiten gedruckt werden sollen. Der Text und die Grafiken werden im Gerätekontext ausgegeben, wenn GdiEndPageEMF aufgerufen wird.

Der Druckprozessor verwendet prectClip , um den rechteckigen Bereich zu beschreiben, der gedruckt werden soll, und prectDocument , um ein Rechteck zu beschreiben, in das die Dokumentseite (oder der abgeschnittene Bereich) passen muss. Wenn prectClipNULL ist, wird die gesamte Dokumentseite gedruckt. Bei Nicht-NULL-Werten von prectClip wird nur der Teil der Dokumentseite innerhalb des Clipbereichs gedruckt. Die GdiPlayPageEMF-Funktion führt dann die Skalierungs- und Übersetzungsvorgänge aus, die erforderlich sind, damit die Dokumentseite (oder der ausgewählte Teil) in das Rechteck passt.

Der prectBorder-Parameter beschreibt, wenn er nicht NULL ist, ein Rechteck mit Rahmenrahmen, das um die Dokumentseite gezeichnet werden soll. Wenn prectBorderNULL ist, wird kein solcher Rahmen gezeichnet.

Weitere Informationen finden Sie unter Verwenden von GDI-Funktionen in Druckprozessoren.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header winppi.h (winppi.h einschließen)
Bibliothek Gdi32.Lib
DLL Gdi32.dll

Weitere Informationen

GdiEndPageEMF