Fonction GetEnhMetaFilePaletteEntries (wingdi.h)

Article
08/27/2023

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