GdiPlayPageEMF-Funktion (winppi.h)
Die GdiPlayPageEMF--Funktion gibt die EMF-Datensätze innerhalb eines angegebenen Rechtecks für eine Dokumentseite eines spoolierten Druckauftrags wieder.
Syntax
BOOL GdiPlayPageEMF(
HANDLE SpoolFileHandle,
HANDLE hemf,
RECT *prectDocument,
RECT *prectBorder,
RECT *prectClip
);
Parameter
SpoolFileHandle
Vom Aufrufer bereitgestellter Spooldateihandle, abgerufen durch einen vorherigen Aufruf von GdiGetSpoolFileHandle.
hemf
Vom Aufrufer bereitgestellter Seitenhandle, abgerufen durch Aufrufen GdiGetPageHandle, die 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 das Zeichenblatt gezeichnet werden soll.
prectBorder
Vom Aufrufer bereitgestellter Zeiger auf eine RECT-Struktur, die das Rahmenrechteck der Seite angibt (sofern 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 TRUEzurück. Andernfalls gibt die Funktion FALSE-zurück, und ein Fehlercode kann durch Aufrufen GetLastError-abgerufen werden.
Bemerkungen
Die GdiPlayPageEMF--Funktion wird von gdi32.dll für die Verwendung innerhalb 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 gedruckt wird, 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 gedruckt, 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 beschnittene Bereich) passen muss. Wenn prectClip-NULL-ist, wird die gesamte Dokumentseite gedruckt. Bei nicht-NULL- Werten von prectClipwird 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, wenn er nichtNULL-ist, beschreibt ein Rechteck mit einfarbigem Rahmen, 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- | Universal |
| Header- | winppi.h (include Winppi.h) |
| Library | Gdi32.Lib |
| DLL- | Gdi32.dll |