Leer en inglés

Compartir a través de


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 de 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 FALSEy se puede obtener un código de error llamando a GetLastError.

Observaciones

El gdi32.dll gdi32.dll de GdiPlayPageEM F exporta 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 valores que no sonNULL de prectClip, solo se imprimirá la parte de la página del documento dentro de la región del clip. 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 esNULL, 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á dicho borde.

Para obtener más información, consulte Uso de funciones GDI en procesadores de impresión.

Requisitos

Requisito Valor
de la plataforma de destino de Universal
encabezado de winppi.h (incluya Winppi.h)
biblioteca de Gdi32.Lib
DLL de Gdi32.dll

Consulte también

GdiEndPageEMF