GdiPlayPageEMF, fonction (winppi.h)
La fonction GdiPlayPageEMF lit les enregistrements EMF dans un rectangle spécifié pour une page de document d’un travail d’impression enpool.
Syntaxe
BOOL GdiPlayPageEMF(
HANDLE SpoolFileHandle,
HANDLE hemf,
RECT *prectDocument,
RECT *prectBorder,
RECT *prectClip
);
Paramètres
SpoolFileHandle
Handle de fichier de pool fourni par l’appelant, obtenu par un appel précédent à GdiGetSpoolFileHandle.
hemf
Handle de page fourni par l’appelant, obtenu en appelant GdiGetPageHandle, identifiant la page pour laquelle les enregistrements doivent être lus.
prectDocument
Pointeur fourni par l’appelant vers une structure de RECT spécifiant le rectangle dans lequel la page doit être dessinée.
prectBorder
Pointeur fourni par l’appelant vers une structure RECT spécifiant le rectangle de bordure de la page (le cas échéant). Peut être NULL .
prectClip
Pointeur fourni par l’appelant vers une structure RECT spécifiant les coordonnées de la région clip de la page (le cas échéant). Peut être NULL .
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 GdiPlayPageEMF est exportée par gdi32.dll à utiliser dans la fonction PrintDocumentOnPrintProcessor d’un processeur d’impression.
La fonction GdiPlayPageEMF est le moyen par lequel un processeur d’impression positionne une page de document ou une région rectangulaire spécifiée d’une page de document sur une page physique. 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é.
Le processeur d’impression utilise préctClip pour décrire la région rectangulaire à imprimer, et prectDocument pour décrire un rectangle dans lequel la page de document (ou région clippée) doit correspondre. Si préctClip est NULL, la page de document entière est imprimée. Pour les valeurs denull non- de préctClip, seule la partie de la page de document dans la région clip sera imprimée. La fonction GdiPlayPageEMF effectue ensuite les opérations de mise à l’échelle et de traduction requises pour que la page de document (ou partie sélectionnée) s’intègre dans le rectangle.
Le paramètre prectBorder, s’il n’est pasNULL, décrit un rectangle de bordure de ligne unie à dessiner autour de la page du document. Si prectBorder est NULL, aucune bordure de ce type n’est dessinée.
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 |