wglGetLayerPaletteEntries-Funktion (wingdi.h)
Ruft die Paletteneinträge aus einer bestimmten Farbindexebene für einen angegebenen Gerätekontext ab.
Syntax
int wglGetLayerPaletteEntries(
HDC unnamedParam1,
int unnamedParam2,
int unnamedParam3,
int unnamedParam4,
COLORREF *unnamedParam5
);
Parameter
unnamedParam1
Typ: HDC
Der Gerätekontext eines Fensters, dessen Ebenen beschrieben werden sollen.
unnamedParam2
Typ: int
Die Überlagerungs- oder Unterlageebene. 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
Typ: int
Der erste abzurufende Paletteneintrag.
unnamedParam4
Typ: int
Die Anzahl der abzurufenden Paletteneinträge.
unnamedParam5
Typ: COLORREF*
Ein Array von Strukturen, die RGB-Farbwerte der Palette enthalten. Das Array muss mindestens so viele Strukturen enthalten, wie von cEntries angegeben.
Rückgabewert
Typ: int
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Einträge, die in der Palette auf der angegebenen Ebenenebene des Fensters festgelegt wurden.
Wenn die Funktion fehlschlägt oder kein Pixelformat ausgewählt wird, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Jede Farbindexebene in einem Fenster verfügt über eine Palette mit einer Größe von 2^n, wobei n die Anzahl der Bitebenen in der Ebenenebene ist. Sie können den transparenten Index einer Palette nicht ändern.
Verwenden Sie die wglRealizeLayerPalette-Funktion , um die Ebenenpalette zu realisieren. Anfangs enthält die Ebenenpalette nur Einträge für Weiß.
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 |