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

Consulte también

GdiEndPageEMF