wingdi.h


EndPage

La función EndPage informa al dispositivo de que la aplicación ha finalizado de escribir en una página. Esta función se usa generalmente para indicar al controlador de impresora que avance a una nueva página. Esta función reemplaza a la secuencia de escape de impresora NEWFRAME.

Sintaxis

int EndPage(
    HDC hdc,   // manipulador de contexto de dispositivo
   );

Parámetros

hdc: Identifica el contexto de dispositivo del trabajo de impresión.

Valor de retorno

Si la función tiene éxito, el valor de retorno es mayor de cero.

Si la función falla, el valor de retorno es menor o igual a cero. Para obtener información adicional sobre el error, usar la función GetLastError.

Observaciones

Usar la función ResetDC para cambiar el modo del despositivo, si es necesario, después de llamara la función EndPage. Tener en cuenta que llamar a ResetDC resetea todos los atributos del contexto de dispositivo a sus valores por defecto.

Windows 3.x: EndPage resetea los atributos del contexto de dispositivo a sus valores por defecto. Es necesario volver a seleccionar los objetos y seleccionar el modo de proyección cada vez antes de imprimir la siguiente página.

Windows 95: EndPage no resetea los atributos del contexto de dispositivo. Sin embargo, la siguiente llamada a StartPage resetea los atributos a sus valores por defecto. En ese momento, se deben seleccionar de nuevo los objetos y seleccionar el modo de proyección de nuevo antes de imprimir la siguiente página. Además, StartPage también resetea la pila de estado del contexto de dispositivo usada por las funciones SaveDC y RestoreDC a sus valores por defecto.

Windows NT: A partir de la versión 3.5 de Windows NT, ni EndPage, ni StartPage resetean los atributos del contexto de dispositivo. Estos atributos se mantienen constantes a través de las páginas siguientes. No es necesario volver a seleccionar los objetos o ajustar el modo de proyección de nuevo antes de imprimir la siguiente página; sin embargo, hacerlo produce los mismos resultados, y reduce las diferencias de código entre Windows 95 y Windows NT.