GdiPlayPageEMF-Funktion (winppi.h)
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 |