Partager via


fonction wglSetLayerPaletteEntries (wingdi.h)

Définit les entrées de palette dans un plan de couche d’index de couleur donné pour un contexte d’appareil spécifié.

Syntaxe

int wglSetLayerPaletteEntries(
  HDC            unnamedParam1,
  int            unnamedParam2,
  int            unnamedParam3,
  int            unnamedParam4,
  const COLORREF *unnamedParam5
);

Paramètres

unnamedParam1

Type : HDC

Contexte d’appareil d’une fenêtre dont la palette de couches doit être définie.

unnamedParam2

Type : int

Plan de superposition ou de sous-couche. Les valeurs positives d’iLayerPlane identifient les plans de superposition, où 1 est le premier plan de superposition au-dessus du plan de main, 2 est le deuxième plan de superposition sur le premier plan de superposition, et ainsi de suite. Les valeurs négatives identifient les plans de sous-couche, où 1 est le premier plan de sous-couche sous le plan de main, 2 est le deuxième plan de sous-couche sous le premier plan de sous-couche, et ainsi de suite. Le nombre de plans de superposition et de sous-couche est indiqué dans le membre bReserved de la structure PIXELFORMATDESCRIPTOR .

unnamedParam3

Type : int

Première entrée de palette à définir.

unnamedParam4

Type : int

Nombre d’entrées de palette à définir.

unnamedParam5

Type : const COLORREF*

Pointeur vers le premier membre d’un tableau de structures cEntries qui contiennent des informations de couleur RVB.

Valeur retournée

Type : int

Si la fonction réussit, la valeur de retour correspond au nombre d’entrées qui ont été définies dans la palette dans le plan de couche spécifié de la fenêtre. Si la fonction échoue ou si aucun format de pixel n’est sélectionné, la valeur de retour est zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Chaque plan d’index de couleur d’une fenêtre a une palette de taille 2^n, où n est le nombre de plans de bits dans le plan de couche. Vous ne pouvez pas modifier l’index transparent d’une palette.

Utilisez la fonction wglRealizeLayerPalette pour réaliser la palette de couches. Initialement, la palette de calques contient uniquement des entrées pour le blanc.

La fonction wglSetLayerPaletteEntries ne définit pas les entrées de palette de la palette de plan main. Pour mettre à jour la palette de plans main, utilisez les fonctions de palette GDI.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête wingdi.h
Bibliothèque Opengl32.lib
DLL Opengl32.dll

Voir aussi

LAYERPLANEDESCRIPTOR

OpenGL sur Windows

PIXELFORMATDESCRIPTOR

Fonctions WGL

wglDescribeLayerPlane

wglGetLayerPaletteEntries

wglRealizeLayerPalette