GdiEndPageEMF, fonction (winppi.h)
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 de pool 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
Activer l’optimisation des couleurs. Pour plus d’informations, consultez Remarques.
Valeur de retour
Si l’opération réussit, la fonction retourne TRUE. Sinon, la fonction retourne FAUX, et un code d’erreur peut être obtenu en appelant GetLastError.
Remarques
La fonction GdiEndPageEMF est exportée par gdi32.dll à utiliser 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 le nombre approprié de pages de document placées 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 fois qu’un appel à GdiGetDevmodeForPage indique que la structure DEVMODEW d’une page de document est différente de la structure DEVMODE de la page précédente.
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 de couleur en noir et blanc lorsqu’ils sont imprimés sur des documents noirs et blancs. Pour vous assurer que les filigranes de couleur s’impriment correctement avec des documents de couleur et 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’Unidrv *ChangeColorModeOnDoc ? attribut de couleur (voir Attributs de couleur).
Pour plus d’informations, consultez Utilisation de fonctions GDI dans les processeurs d’impression.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | winppi.h (inclure Winppi.h) |
| bibliothèque | Gdi32.Lib |
| DLL | Gdi32.dll |