Fonction GetEnhMetaFilePaletteEntries (wingdi.h)
La fonction GetEnhMetaFilePaletteEntries récupère les entrées de palette facultatives à partir du métafichier amélioré spécifié.
Syntaxe
UINT GetEnhMetaFilePaletteEntries(
[in] HENHMETAFILE hemf,
[in] UINT nNumEntries,
[out] LPPALETTEENTRY lpPaletteEntries
);
Paramètres
[in] hemf
Handle du métafichier amélioré.
[in] nNumEntries
Nombre d’entrées à récupérer à partir de la palette facultative.
[out] lpPaletteEntries
Pointeur vers un tableau de structures PALETTEENTRY qui reçoit les couleurs de la palette. Le tableau doit contenir au moins autant de structures que d’entrées spécifiées par le paramètre cEntries .
Valeur retournée
Si le pointeur du tableau a la valeur NULL et que le métafichier amélioré contient une palette facultative, la valeur de retour correspond au nombre d’entrées dans la palette du métafichier amélioré ; si le pointeur du tableau est un pointeur valide et que le métafichier amélioré contient une palette facultative, la valeur de retour correspond au nombre d’entrées copiées ; si le métafichier ne contient pas de palette facultative, la valeur de retour est zéro. Sinon, la valeur de retour est GDI_ERROR.
Remarques
Une application peut stocker une palette facultative dans un métafichier amélioré en appelant les fonctions CreatePalette et SetPaletteEntries avant de créer l’image et de la stocker dans le métafichier. Ce faisant, l’application peut obtenir des couleurs cohérentes lorsque l’image est affichée sur divers appareils.
Une application qui affiche une image stockée dans un métafichier amélioré peut appeler la fonction GetEnhMetaFilePaletteEntries pour déterminer si la palette facultative existe. Si c’est le cas, l’application peut appeler la fonction GetEnhMetaFilePaletteEntries une deuxième fois pour récupérer les entrées de palette, puis créer une palette logique (à l’aide de la fonction CreatePalette ), la sélectionner dans son contexte d’appareil (à l’aide de la fonction SelectPalette ), puis la réaliser (à l’aide de la fonction RealizePalette ). Une fois la palette logique réalisée, l’appel de la fonction PlayEnhMetaFile affiche l’image à l’aide de ses couleurs d’origine.
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 |