Funzione GetEnhMetaFilePaletteEntries (wingdi.h)
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 |