wglRealizeLayerPalette-Funktion (wingdi.h)
Die wglRealizeLayerPalette-Funktion ordnet Paletteneinträge aus einer bestimmten Farbindexebene der physischen Palette zu oder initialisiert die Palette einer RGBA-Ebenenebene.
Syntax
BOOL wglRealizeLayerPalette(
HDC unnamedParam1,
int unnamedParam2,
BOOL unnamedParam3
);
Parameter
unnamedParam1
Gibt den Gerätekontext eines Fensters an, dessen Ebenenebenenpalette in der physischen Palette realisiert werden soll.
unnamedParam2
Gibt die Überlagerungs- oder Unterlageebene an. Positive Werte von iLayerPlane identifizieren Überlagerungsebenen, wobei 1 die erste Überlagerungsebene über der Standard-Ebene, 2 die zweite Überlagerungsebene über der ersten Überlagerungsebene ist usw. Negative Werte identifizieren Unterlageebenen, wobei 1 die erste Unterlageebene unter der Standard Ist, 2 die zweite Unterlageebene unter der ersten Unterlageebene usw. ist. Die Anzahl der Überlagerungs- und Unterlageebenen wird im bReserved-Element der PIXELFORMATDESCRIPTOR-Struktur angegeben.
unnamedParam3
Gibt an, ob die Palette in die physische Palette integriert werden soll. Wenn bRealizeauf TRUE festgelegt ist, werden die Paletteneinträge der physischen Palette zugeordnet, sofern verfügbar. Wenn bRealizeauf FALSE festgelegt ist, werden die Paletteneinträge für die Ebenenebene des Fensters nicht mehr benötigt und möglicherweise für die Verwendung durch ein anderes Vordergrundfenster freigegeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE, auch wenn bRealizeTRUE ist und die physische Palette nicht verfügbar ist. Wenn die Funktion fehlschlägt oder kein Pixelformat ausgewählt ist, ist der Rückgabewert FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die physische Palette für eine Ebenenebene ist eine gemeinsam genutzte Ressource zwischen Fenstern mit Ebenenebenen. Wenn mehr als ein Fenster versucht, eine Palette für eine bestimmte physische Ebenenebene zu realisieren, wird jeweils nur eine Palette realisiert. Wenn Sie die wglRealizeLayerPalette-Funktion aufrufen, wird die Ebenenpalette eines Vordergrundfensters immer zuerst realisiert.
Wenn die Ebenenpalette eines Fensters realisiert wird, werden seine Paletteneinträge immer 1:1 der physischen Palette zugeordnet. Im Gegensatz zu logischen GDI-Paletten gibt es bei wglRealizeLayerPalette keine Zuordnung der Ebenenpaletten anderer Fenster zur aktuellen physischen Palette.
Wenn ein Fenster zum Vordergrundfenster wird, rufen Sie wglRealizeLayerPalette auf, um die Ebenenpaletten wieder zu realisieren, auch wenn der Pixeltyp der Ebenenebene RGBA ist.
Da wglRealizeLayerPalette die Palette der Standard-Ebene nicht realisiert, verwenden Sie GDI-Palettenfunktionen, um die Standard Ebenenpalette zu realisieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h |
| Bibliothek | Opengl32.lib |
| DLL | Opengl32.dll |