Fonction PlayMetaFile (wingdi.h)

La fonction PlayMetaFile affiche l’image stockée dans le métafichier au format Windows donné sur l’appareil spécifié.

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 pour un métafichier au format amélioré est PlayEnhMetaFile.

 

Syntaxe

BOOL PlayMetaFile(
  [in] HDC       hdc,
  [in] HMETAFILE hmf
);

Paramètres

[in] hdc

Handle vers un contexte de périphérique.

[in] hmf

Gérer dans un métafichier au format Windows.

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 .

Un métafichier au format Windows peut être lu plusieurs fois.

Un métafichier au format Windows peut être incorporé dans un deuxième métafichier au format Windows en appelant la fonction PlayMetaFile et en lisant le métafichier source dans le contexte de l’appareil pour le métafichier cible.

Tout objet créé mais non supprimé dans le métafichier au format Windows est supprimé par cette fonction.

Pour arrêter cette fonction, une application peut appeler la fonction CancelDC à partir d’un autre thread pour mettre fin à l’opération. Dans ce cas, la fonction retourne FALSE.

Configuration requise

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

CancelDC

Fonctions de métafichier

Vue d’ensemble des métafichiers

SetWinMetaFileBits