Funzione GetEnhMetaFilePaletteEntries (wingdi.h)

Articolo
08/27/2023

La funzione GetEnhMetaFilePaletteEntries recupera le voci facoltative della tavolozza dal metafile avanzato specificato.

Sintassi

UINT GetEnhMetaFilePaletteEntries(
  [in]  HENHMETAFILE   hemf,
  [in]  UINT           nNumEntries,
  [out] LPPALETTEENTRY lpPaletteEntries
);

Parametri

[in] hemf

Handle per il metafile avanzato.

[in] nNumEntries

Numero di voci da recuperare dal tavolozza facoltativo.

[out] lpPaletteEntries

Puntatore a una matrice di strutture PALETTEENTRY che ricevono i colori della tavolozza. La matrice deve contenere almeno il numero di strutture specificate dal parametro cEntries .

Valore restituito

Se il puntatore della matrice è NULL e il metafile avanzato contiene una tavolozza facoltativa, il valore restituito è il numero di voci nel riquadro dei metafile avanzati; se il puntatore della matrice è un puntatore valido e il metafile avanzato contiene una tavolozza facoltativa, il valore restituito è il numero di voci copiate; se il metafile non contiene una tavolozza facoltativa, il valore restituito è zero. In caso contrario, il valore restituito è GDI_ERROR.

Commenti

Un'applicazione può archiviare un riquadro facoltativo in un metafile avanzato chiamando le funzioni CreatePalette e SetPaletteEntries prima di creare l'immagine e archiviarla nel metafile. A questo scopo, l'applicazione può ottenere colori coerenti quando l'immagine viene visualizzata in un'ampia gamma di dispositivi.

Un'applicazione che visualizza un'immagine archiviata in un metafile avanzato può chiamare la funzione GetEnhMetaFilePaletteEntries per determinare se esiste la tavolozza facoltativa. In caso affermativo, l'applicazione può chiamare la funzione GetEnhMetaFilePaletteEntries per recuperare le voci della tavolozza e quindi creare una tavolozza logica (usando la funzione CreatePalette ), selezionarla nel contesto del dispositivo (usando la funzione SelectPalette ) e quindi eseguirla (usando la funzione RealizePalette ). Dopo aver realizzato la tavolozza logica, la chiamata alla funzione PlayEnhMetaFile visualizza l'immagine usando i colori originali.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll