Función StartPage (wingdi.h)

Artículo
03/08/2023

La función StartPage prepara el controlador de impresora para aceptar datos.

Sintaxis

int StartPage(
  [in] HDC hdc
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo para el trabajo de impresión.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es mayor que cero.

Si se produce un error en la función, el valor devuelto es menor o igual que cero.

Comentarios

Nota Se trata de una función de bloqueo o sincrónica y podría no devolverse inmediatamente. La rapidez con la que devuelve esta función depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y la implementación del controlador de impresora, factores que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.

El sistema deshabilita la función ResetDC entre las llamadas a las funciones StartPage y EndPage . Esto significa que no se puede cambiar el modo de dispositivo excepto en los límites de la página. Después de llamar a EndPage, puedes llamar a ResetDC para cambiar el modo de dispositivo, si es necesario. Tenga en cuenta que una llamada a ResetDC restablece todos los atributos de contexto del dispositivo a los valores predeterminados.

Ni EndPage ni StartPage restablecen los atributos de contexto del dispositivo. Los atributos de contexto del dispositivo permanecen constantes en las páginas posteriores. No es necesario volver a seleccionar objetos y volver a configurar el modo de asignación antes de imprimir la página siguiente; sin embargo, al hacerlo, se producirán los mismos resultados y se reducirán las diferencias de código entre las versiones de Windows.

Ejemplos

Para obtener un programa de ejemplo que use esta función, consulte How To: Print Using the GDI Print API.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll