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 en pool.

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 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 zone de découpage de la page (le cas échéant). Peut être NULL.

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 GdiPlayPageEMF est exportée par gdi32.dll pour une utilisation 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 zone rectangulaire spécifiée d’une page de document sur une page physique. Notez que GdiPlayPageEMF ne s’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 prectClip pour décrire la région rectangulaire à imprimer, et prectDocument pour décrire un rectangle dans lequel la page du document (ou la région coupée) doit tenir. Si prectClip a la valeur NULL, la page entière du document est imprimée. Pour les valeurs non NULL de prectClip, seule la partie de la page de document dans la zone de clip est imprimée. La fonction GdiPlayPageEMF effectue ensuite les opérations de mise à l’échelle et de traduction nécessaires pour que la page de document (ou la partie sélectionnée) s’ajuste dans le rectangle.

Le paramètre prectBorder , s’il n’est pas NULL, décrit un rectangle de bordure pleine à dessiner autour de la page du document. Si prectBorder a la valeur NULL, aucune bordure de ce type n’est dessinée.

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

Configuration requise

Voir aussi

GdiEndPageEMF