funzione wglRealizeLayerPalette (wingdi.h)
La funzione wglRealizeLayerPalette esegue il mapping delle voci del tavolozza da un determinato piano livello di indice colore nella tavolozza fisica o inizializza la tavolozza di un piano di livello RGBA.
Sintassi
BOOL wglRealizeLayerPalette(
HDC unnamedParam1,
int unnamedParam2,
BOOL unnamedParam3
);
Parametri
unnamedParam1
Specifica il contesto del dispositivo di una finestra il cui tavolozza piano livello deve essere realizzato nella tavolozza fisica.
unnamedParam2
Specifica il piano di sovrapposizione o sottolay. I valori positivi di iLayerPlane identificano i piani di sovrapposizione, dove 1 è il primo piano di sovrapposizione sul piano principale, 2 è il secondo piano di sovrapposizione sul primo piano di sovrapposizione e così via. I valori negativi identificano i piani di sottolay, dove 1 è il primo piano di sottolay sotto il piano principale, 2 è il secondo piano sotto il primo piano di sottolay e così via. Il numero di piani di sovrapposizione e sottolay viene specificato nel membro bReserved della struttura PIXELFORMATDESCRIPTOR .
unnamedParam3
Indica se la tavolozza deve essere realizzata nella tavolozza fisica. Quando bRealize è TRUE, le voci della tavolozza vengono mappate nella tavolozza fisica in cui è disponibile. Quando bRealize è FALSE, le voci della tavolozza per il piano livello della finestra non sono più necessarie e potrebbero essere rilasciate da un'altra finestra in primo piano.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è TRUE, anche se bRealize è TRUE e la tavolozza fisica non è disponibile. Se la funzione ha esito negativo o quando non è selezionato alcun formato pixel, il valore restituito è FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
La tavolozza fisica per un piano livello è una risorsa condivisa tra le finestre con i piani di livello. Quando più finestre tentano di realizzare una tavolozza per un determinato piano di livello fisico, viene realizzata una sola tavolozza alla volta. Quando si chiama la funzione wglRealizeLayerPalette , la tavolozza dei livelli di una finestra in primo piano viene sempre realizzata.
Quando viene realizzata la tavolozza dei livelli di una finestra, le voci della tavolozza vengono sempre mappate uno a uno nella tavolozza fisica. A differenza delle tavolozze logiche GDI, con wglRealizeLayerPalette non esiste alcun mapping delle altre tavolozze dei livelli di windows alla tavolozza fisica corrente.
Ogni volta che una finestra diventa in primo piano, chiamare wglRealizeLayerPalette per realizzare di nuovo le tavolozze dei livelli, anche se il tipo di pixel del piano di livello è RGBA.
Poiché wglRealizeLayerPalette non si rende conto della tavolozza del piano principale, usare le funzioni della tavolozza GDI per realizzare la tavolozza del piano principale.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |
| Libreria | Opengl32.lib |
| DLL | Opengl32.dll |