Fonction SetWinMetaFileBits (wingdi.h)
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 |