PlayEnhMetaFileRecord, fonction (wingdi.h)

La fonction PlayEnhMetaFileRecord lit un enregistrement enhanced-metafile en exécutant les fonctions GDI (Graphics Device Interface) identifiées par l’enregistrement.

Syntaxe

BOOL PlayEnhMetaFileRecord(
  [in] HDC                 hdc,
  [in] LPHANDLETABLE       pht,
  [in] const ENHMETARECORD *pmr,
  [in] UINT                cht
);

Paramètres

[in] hdc

Handle du contexte d’appareil passé à la fonction EnumEnhMetaFile .

[in] pht

Pointeur vers une table de handles vers des objets GDI utilisés lors de la lecture du métafichier. La première entrée de ce tableau contient le handle enhanced-metafile.

[in] pmr

Pointeur vers l’enregistrement enhanced-metafile à lire.

[in] cht

Nombre de handles dans la table de handles.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Il s’agit d’une fonction enhanced-metafile.

Une application utilise généralement PlayEnhMetaFileRecord conjointement avec la fonction EnumEnhMetaFile pour traiter et lire un métafichier au format amélioré, un enregistrement à la fois.

Les paramètres hdc, lpHandletable et nHandles doivent être exactement ceux passés à la procédure de rappel EnhMetaFileProc par la fonction EnumEnhMetaFile .

Si PlayEnhMetaFileRecord ne reconnaît pas un enregistrement, il ignore l’enregistrement et retourne TRUE.

Configuration requise

Condition requise Valeur
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

EnumEnhMetaFile

Fonctions de métafichier

Vue d’ensemble des métafichiers

PlayEnhMetaFile