Función GdiPlayPageEMF (winppi.h)
La función GdiPlayPageEMF reproduce los registros EMF dentro de un rectángulo especificado para una página de documento de un trabajo de impresión en cola.
Sintaxis
BOOL GdiPlayPageEMF(
HANDLE SpoolFileHandle,
HANDLE hemf,
RECT *prectDocument,
RECT *prectBorder,
RECT *prectClip
);
Parámetros
SpoolFileHandle
Identificador de archivo de cola proporcionado por el autor de la llamada, obtenido por una llamada anterior a GdiGetSpoolFileHandle.
hemf
Identificador de página proporcionado por el autor de la llamada, obtenido llamando a GdiGetPageHandle, identificando la página para la que se reproducirán los registros.
prectDocument
Puntero proporcionado por el autor de la llamada a una estructura RECT que especifica el rectángulo en el que se va a dibujar la página.
prectBorder
Puntero proporcionado por el autor de la llamada a una estructura RECT que especifica el rectángulo de borde de la página (si existe). Puede ser NULL.
prectClip
Puntero proporcionado por el autor de la llamada a una estructura RECT que especifica las coordenadas de la región del clip de la página (si existe). Puede ser NULL.
Valor devuelto
Si la operación se realiza correctamente, la función devuelve TRUE. De lo contrario, la función devuelve FALSE y se puede obtener un código de error llamando a GetLastError.
Comentarios
La función GdiPlayPageEMF se exporta mediante gdi32.dll para su uso en la función PrintDocumentOnPrintProcessor de un procesador de impresión.
La función GdiPlayPageEMF es el medio por el que un procesador de impresión coloca una página de documento o una región rectangular especificada de una página de documento en una página física. Tenga en cuenta que GdiPlayPageEMF no imprime realmente en el contexto del dispositivo, sino que prepara una estructura de datos que describe el texto y los gráficos que se van a imprimir en las páginas físicas. El texto y los gráficos se imprimen en el contexto del dispositivo cuando se llama a GdiEndPageEMF .
El procesador de impresión usa prectClip para describir la región rectangular que se va a imprimir y prectDocument para describir un rectángulo en el que debe caber la página del documento (o región recortada). Si prectClip es NULL, se imprimirá toda la página del documento. En el caso de los valores que no son NULL de prectClip, solo se imprimirá la parte de la página del documento dentro de la región del clip. A continuación, la función GdiPlayPageEMF realiza las operaciones de escalado y traducción necesarias para que la página del documento (o parte seleccionada) se ajuste al rectángulo.
El parámetro prectBorder , si no es NULL, describe un rectángulo de borde de línea sólida que se va a dibujar alrededor de la página del documento. Si prectBorder es NULL, no se dibujará este borde.
Para obtener más información, consulte Uso de funciones GDI en procesadores de impresión.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | winppi.h (incluya Winppi.h) |
| Library | Gdi32.Lib |
| Archivo DLL | Gdi32.dll |