Funzione GdiPlayPageEMF (winppi.h)
La funzione GdiPlayPageEMF riproduce i record EMF all'interno di un rettangolo specificato per una pagina del 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 riprodurre 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 clip 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 FALSE e è possibile ottenere un codice di errore chiamando GetLastError.
Commenti
La funzione GdiPlayPageEMF viene esportata da gdi32.dll da usare all'interno della funzione PrintDocumentOnPrintProcessor di un processore di stampa.
La funzione GdiPlayPageEMF è il mezzo per cui un processore di stampa posiziona una pagina di documento o un'area rettangolare specificata di una pagina di 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 gli elementi grafici da stampare nelle pagine fisiche. Il testo e la grafica vengono stampati nel contesto del dispositivo quando viene chiamato GdiEndPageEMF .
Il processore di stampa usa 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 non NULL di prectClip, verrà stampata solo la parte della pagina del documento all'interno dell'area clip. La funzione GdiPlayPageEMF esegue quindi 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 linee solide 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 nei processori di stampa.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | winppi.h (include Winppi.h) |
| Libreria | Gdi32.Lib |
| DLL | Gdi32.dll |