PlayMetaFileRecord, fonction (wingdi.h)

Article
08/27/2023

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