Fonction SetWinMetaFileBits (wingdi.h)

Article
03/04/2024

La fonction SetWinMetaFileBits convertit un métafichier de l’ancien format Windows en nouveau format amélioré et stocke le nouveau métafichier en mémoire.

Syntaxe

HENHMETAFILE SetWinMetaFileBits(
  [in] UINT               nSize,
  [in] const BYTE         *lpMeta16Data,
  [in] HDC                hdcRef,
  [in] const METAFILEPICT *lpMFP
);

Paramètres

[in] nSize

Taille, en octets, de la mémoire tampon qui contient le métafichier au format Windows.

[in] lpMeta16Data

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

[in] hdcRef

Handle d’un contexte d’appareil de référence.

[in] lpMFP

Pointeur vers une structure METAFILEPICT qui contient la taille suggérée de l’image de métafichier et le mode de mappage utilisé lors de la création de l’image.

Valeur retournée

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

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

Remarques

Windows utilise les données de résolution du contexte d’appareil de référence et les données de la structure METAFILEPICT pour mettre à l’échelle une image. Si le paramètre hdcRef a la valeur NULL, le système utilise les données de résolution pour l’appareil de sortie actuel. Si le paramètre lpmfp a la valeur NULL, le système utilise le mode de mappage MM_ANISOTROPIC pour mettre à l’échelle l’image afin qu’elle s’adapte à l’ensemble de la surface de l’appareil. Le membre hMF de la structure METAFILEPICT n’est pas utilisé.

Lorsque l’application n’a plus besoin du handle de métafichier amélioré, elle doit le supprimer en appelant la fonction DeleteEnhMetaFile .

Le handle retourné par cette fonction peut être utilisé avec d’autres fonctions de métafichier amélioré.

Si le contexte de l’appareil de référence n’est pas identique à l’appareil dans lequel le métafichier a été créé à l’origine, certaines fonctions GDI qui utilisent des unités d’appareil peuvent ne pas dessiner correctement l’image.

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