Partager via


Fonction SetMetaFileBitsEx (wingdi.h)

La fonction SetMetaFileBitsEx crée un métafichier au format Windows basé sur la mémoire à partir des données fournies.

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 SetEnhMetaFileBits.
 

Syntaxe

HMETAFILE SetMetaFileBitsEx(
  [in] UINT       cbBuffer,
  [in] const BYTE *lpData
);

Paramètres

[in] cbBuffer

Spécifie la taille, en octets, du métafichier au format Windows.

[in] lpData

Pointeur vers une mémoire tampon qui contient le métafichier au format Windows. (Il est supposé que les données ont été obtenues à l’aide de la fonction GetMetaFileBitsEx .)

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle vers un métafichier au format Windows basé sur la mémoire.

Si la fonction échoue, la valeur de retour est NULL.

Remarques

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

Lorsque l’application n’a plus besoin du handle de métafichier retourné par SetMetaFileBitsEx, elle doit la supprimer en appelant la fonction DeleteMetaFile .

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

DeleteMetaFile

GetMetaFileBitsEx

Fonctions de métafichier

Vue d’ensemble des métafichiers

SetEnhMetaFileBits

SetWinMetaFileBits