Partager via


PlayMetaFileRecord, fonction (wingdi.h)

La fonction PlayMetaFileRecord lit un enregistrement de métafichier au format Windows en exécutant la fonction GDI (Graphics Device Interface) contenue dans cet enregistrement.

Note Cette fonction est fournie uniquement pour la compatibilité avec les métafichiers au format Windows. Les métafichiers de format amélioré offrent des fonctionnalités supérieures et sont recommandés pour les nouvelles applications. La fonction correspondante d’un métafichier au format amélioré est PlayEnhMetaFileRecord.
 

Syntaxe

BOOL PlayMetaFileRecord(
  [in] HDC           hdc,
  [in] LPHANDLETABLE lpHandleTable,
  [in] LPMETARECORD  lpMR,
  [in] UINT          noObjs
);

Paramètres

[in] hdc

Handle d'un contexte de périphérique.

[in] lpHandleTable

Pointeur vers une structure HANDLETABLE représentant la table des handles vers les objets GDI utilisés lors de la lecture du métafichier.

[in] lpMR

Pointeur vers l’enregistrement de métafichier au format Windows.

[in] noObjs

Nombre de handles dans la table handle.

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

Pour convertir un métafichier au format Windows en métafichier de format amélioré, utilisez la fonction SetWinMetaFileBits .

Une application utilise généralement PlayMetaFileRecord conjointement avec la fonction EnumMetaFile pour traiter et lire un métafichier au format Windows un enregistrement à la fois.

Les paramètres lpHandletable et nHandles doivent être identiques à ceux passés à la procédure de rappel EnumMetaFileProc par EnumMetaFile.

Si la fonction PlayMetaFileRecord ne reconnaît pas un enregistrement, elle 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

EnumMetaFile

HANDLETABLE

METARECORD

Fonctions de métafichier

Vue d’ensemble des métafichiers

PlayMetaFile

SetWinMetaFileBits