StartPage, fonction (wingdi.h)

La fonction StartPage prépare le pilote d’imprimante à accepter les données.

Syntaxe

int StartPage(
  [in] HDC hdc
);

Paramètres

[in] hdc

Handle vers le contexte de l’appareil pour le travail d’impression.

Valeur retournée

Si la fonction réussit, la valeur de retour est supérieure à zéro.

Si la fonction échoue, la valeur de retour est inférieure ou égale à zéro.

Remarques

Note Il s’agit d’une fonction bloquante ou synchrone qui peut ne pas être retournée immédiatement. La rapidité avec laquelle cette fonction retourne dépend de facteurs d’exécution tels que l’status réseau, la configuration du serveur d’impression et l’implémentation du pilote d’imprimante, facteurs difficiles à prédire lors de l’écriture d’une application. L’appel de cette fonction à partir d’un thread qui gère l’interaction avec l’interface utilisateur peut donner l’impression que l’application ne répond pas.

 

Le système désactive la fonction ResetDC entre les appels aux fonctions StartPage et EndPage . Cela signifie que vous ne pouvez pas modifier le mode de l’appareil, sauf aux limites de la page. Après avoir appelé EndPage, vous pouvez appeler ResetDC pour modifier le mode de l’appareil, si nécessaire. Notez qu’un appel à ResetDC réinitialise tous les attributs de contexte d’appareil aux valeurs par défaut.

Ni EndPage ni StartPage ne réinitialisent les attributs de contexte de l’appareil. Les attributs de contexte de l’appareil restent constants sur les pages suivantes. Vous n’avez pas besoin de re-sélectionner des objets et de configurer à nouveau le mode de mappage avant d’imprimer la page suivante . Toutefois, cela produira les mêmes résultats et réduira les différences de code entre les versions de Windows.

Exemples

Pour obtenir un exemple de programme qui utilise cette fonction, consultez Guide pratique pour imprimer à l’aide de l’API d’impression GDI.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Voir aussi

EndPage

Fonctions API du spouleur d’impression

Impression

ResetDC