Fonction GdiEndPageEMF (winppi.h)

Article
08/08/2023

La fonction GdiEndPageEMF met fin aux opérations de lecture EMF pour une page physique d’un travail d’impression au format EMF.

Syntaxe

BOOL GdiEndPageEMF(
  HANDLE SpoolFileHandle,
  DWORD  dwOptimization
);

Paramètres

SpoolFileHandle

Handle de fichier spool fourni par l’appelant, obtenu par un appel précédent à GdiGetSpoolFileHandle.

dwOptimization

Indicateurs fournis par l’appelant. L’indicateur suivant est défini :

EMF_PP_COLOR_OPTIMIZATION

Activez l’optimisation des couleurs. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Si l’opération réussit, la fonction retourne TRUE. Sinon, la fonction retourne FALSE et un code d’erreur peut être obtenu en appelant GetLastError.

Remarques

La fonction GdiEndPageEMF est exportée par gdi32.dll pour une utilisation dans la fonction PrintDocumentOnPrintProcessor d’un processeur d’impression.

La fonction GdiEndPageEMF met fin au traitement d’une page physique et l’éjecte de l’imprimante. Un processeur d’impression doit appeler GdiEndPageEMF aux moments suivants :

Une fois que le nombre approprié de pages de document a été placé sur la page physique en effectuant des appels à GdiPlayPageEMF. Notez que GdiPlayPageEMF n’imprime pas réellement sur le contexte de l’appareil, mais prépare plutôt une structure de données qui décrit le texte et les graphiques à imprimer sur la ou les pages physiques. Le texte et les graphiques sont imprimés dans le contexte de l’appareil lorsque GdiEndPageEMF est appelé.
Chaque appel à GdiGetDevmodeForPage indique que la structure DEVMODEW d’une page de document est différente de la structure DEVMODEW de la page précédente.

Si cette fonction est appelée avec le paramètre dwOptimization défini sur EMF_PP_COLOR_OPTIMIZATION, l’optimisation des couleurs est activée. Si dwOptimization est défini sur 0, aucune optimisation n’est effectuée. Lorsque l’optimisation des couleurs est activée, la présence de couleur dans le fichier de spouleur entraîne la lecture du fichier de spoule en couleur ; l’absence de couleur dans le fichier de sppool entraîne la lecture du fichier de spoule en monochrome.

Si vous créez un plug-in de rendu Unidrv pour générer des filigranes de couleur, sachez que l’optimisation des couleurs entraîne l’impression des filigranes en noir et blanc lorsqu’ils sont imprimés sur des documents en noir et blanc. Pour vous assurer que les filigranes de couleur s’impriment correctement avec des documents en couleur et en noir et blanc, désactivez l’optimisation des couleurs.

L’optimisation des couleurs contrôlée par le paramètre dwOptimization peut également être contrôlée en définissant le membre dwColorOptimization des structures ATTRIBUTE_INFO_2 ou ATTRIBUTE_INFO_3 . Cette optimisation peut également être contrôlée par l’attribut de couleur Unidrv *ChangeColorModeOnDoc ? (voir Attributs de couleur).

Pour plus d’informations, consultez Utilisation de fonctions GDI dans les processeurs d’impression.