wglSetLayerPaletteEntries-Funktion (wingdi.h)
Legt die Paletteneinträge in einer bestimmten Farbindexebene für einen angegebenen Gerätekontext fest.
Syntax
int wglSetLayerPaletteEntries(
HDC unnamedParam1,
int unnamedParam2,
int unnamedParam3,
int unnamedParam4,
const COLORREF *unnamedParam5
);
Parameter
unnamedParam1
Typ: HDC
Der Gerätekontext eines Fensters, dessen Ebenenpalette festgelegt werden soll.
unnamedParam2
Typ: int
Eine Überlagerungs- oder Unterlageebene. Positive Werte von iLayerPlane identifizieren Überlagerungsebenen, wobei 1 die erste Überlagerungsebene über der Standard Ist, 2 die zweite Überlagerungsebene über der ersten Überlagerungsebene usw. ist. 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 festzulegende Paletteneintrag.
unnamedParam4
Typ: int
Die Anzahl der festzulegenden Paletteneinträge.
unnamedParam5
Typ: const COLORREF*
Ein Zeiger auf das erste Element eines Arrays von cEntries-Strukturen , die RGB-Farbinformationen enthalten.
Rückgabewert
Typ: int
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Einträge, die in der Palette in der angegebenen Ebenenebene des Fensters festgelegt wurden. Wenn die Funktion fehlschlägt oder kein Pixelformat ausgewählt ist, ist der Rückgabewert 0. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Jede Farbindexebene in einem Fenster verfügt über eine Palette mit der Größe 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ß.
Die wglSetLayerPaletteEntries-Funktion legt die Paletteneinträge der Standard-Ebenenpalette nicht fest. Um die Standard Ebenenpalette zu aktualisieren, verwenden Sie GDI-Palettenfunktionen.
Anforderungen
| 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 |