Funzione RealizePalette (wingdi.h)
La funzione RealizePalette esegue il mapping delle voci della tavolozza logica corrente al tavolozza di sistema.
Sintassi
UINT RealizePalette(
[in] HDC hdc
);
Parametri
[in] hdc
Handle per il contesto del dispositivo in cui è stata selezionata una tavolozza logica.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è il numero di voci nel riquadro logico mappato al tavolozza di sistema.
Se la funzione ha esito negativo, il valore restituito è GDI_ERROR.
Commenti
Un'applicazione può determinare se un dispositivo supporta le operazioni del tavolozza chiamando la funzione GetDeviceCaps e specificando la costante RASTERCAPS.
La funzione RealizePalette modifica la tavolozza per il dispositivo associato al contesto del dispositivo specificato. Se il contesto del dispositivo è un controller di dominio di memoria, la tabella colori per la bitmap selezionata nel controller di dominio viene modificata. Se il contesto del dispositivo è un controller di dominio di visualizzazione, la tavolozza fisica per tale dispositivo viene modificata.
Una tavolozza logica è un buffer tra applicazioni a elevato utilizzo di colori e il sistema, consentendo a queste applicazioni di usare il numero di colori necessari senza interferire con i colori visualizzati da altre finestre.
Quando la finestra di un'applicazione ha lo stato attivo e chiama la funzione RealizePalette , il sistema tenta di realizzare il maggior numero possibile di colori richiesti. Lo stesso vale anche per le applicazioni con finestre inattive.
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 |