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

Vedi anche

GdiEndPageEMF