Fonction EndPage (wingdi.h)

  • Article

La fonction EndPage avertit l’appareil que l’application a terminé l’écriture dans une page. Cette fonction est généralement utilisée pour diriger le pilote de périphérique vers une nouvelle page.

Syntaxe

int EndPage(
  [in] HDC hdc
);

Paramètres

[in] hdc

Handle dans 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.
 
Utilisez la fonction ResetDC pour modifier le mode de l’appareil, si nécessaire, après avoir appelé la fonction EndPage . 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 d’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.

Lorsqu’une page d’un fichier en pool dépasse environ 350 Mo, il se peut qu’elle ne parvient pas à imprimer et qu’elle n’envoie pas de message d’erreur. Par exemple, cela peut se produire lors de l’impression de fichiers EMF volumineux. La limite de taille de page dépend de nombreux facteurs, notamment la quantité de mémoire virtuelle disponible, la quantité de mémoire allouée par les processus appelants et la quantité de fragmentation dans le tas de processus.

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

   
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

Fonctions API du spouleur d’impression

Impression

ResetDC

StartPage