Funzione GdiPlayPageEMF (winppi.h)
La funzione GdiPlayPageEMF riproduce i record EMF all'interno di un rettangolo specificato per una pagina di documento di un processo di stampa con spooling.
Sintassi
BOOL GdiPlayPageEMF(
HANDLE SpoolFileHandle,
HANDLE hemf,
RECT *prectDocument,
RECT *prectBorder,
RECT *prectClip
);
Parametri
SpoolFileHandle
Handle di file di spooling fornito dal chiamante, ottenuto da una chiamata precedente a GdiGetSpoolFileHandle.
hemf
Handle di pagina fornito dal chiamante, ottenuto chiamando GdiGetPageHandle, identificando la pagina per cui devono essere riprodotti i record.
prectDocument
Puntatore fornito dal chiamante a una struttura RECT che specifica il rettangolo in cui deve essere disegnata la pagina.
prectBorder
Puntatore fornito dal chiamante a una struttura RECT che specifica il rettangolo del bordo della pagina (se presente). Può essere NULL.
prectClip
Puntatore fornito dal chiamante a una struttura RECT che specifica le coordinate dell'area di ritaglio della pagina (se presente). Può essere NULL.
Valore restituito
Se l'operazione ha esito positivo, la funzione restituisce TRUE. In caso contrario, la funzione restituisce FALSEe è possibile ottenere un codice di errore chiamando GetLastError.
Osservazioni
La funzione GdiPlayPageEMF viene esportata da gdi32.dll per l'uso all'interno della funzione del processore di stampa PrintDocumentOnPrintProcessor.
La funzione GdiPlayPageEMF è il mezzo in cui un processore di stampa posiziona una pagina documento o un'area rettangolare specificata di una pagina documento in una pagina fisica. Si noti che GdiPlayPageEMF non stampa effettivamente nel contesto del dispositivo, ma prepara invece una struttura di dati che descrive il testo e la grafica da stampare nelle pagine fisiche. Il testo e la grafica vengono stampati nel contesto del dispositivo quando viene chiamato GdiEndPageEMF.
Il processore di stampa utilizza prectClip per descrivere l'area rettangolare da stampare e prectDocument per descrivere un rettangolo in cui deve essere adattata la pagina del documento (o l'area ritagliata). Se prectClip è null, verrà stampata l'intera pagina del documento. Per i valori nullnull di prectClip, verrà stampata solo la parte della pagina del documento all'interno dell'area clip. La funzione GdiPlayPageEMF quindi esegue le operazioni di ridimensionamento e traduzione necessarie per adattare la pagina del documento (o la parte selezionata) al rettangolo.
Il parametro prectBorder, se non èNULL, descrive un rettangolo di bordo a linea continua da disegnare intorno alla pagina del documento. Se prectBorder è NULL, non verrà disegnato alcun bordo di questo tipo.
Per altre informazioni, vedere Uso di funzioni GDI in Processori di stampa.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | winppi.h (include Winppi.h) |
| libreria | Gdi32.Lib |
| dll | Gdi32.dll |