Condividi tramite


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

Vedi anche

Funzioni colore

Panoramica dei colori

CreatePalette

GetDeviceCaps

SelezionarePalette