Fonction SetMetaFileBitsEx (wingdi.h)

Article
08/27/2023

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