fonction wglGetLayerPaletteEntries (wingdi.h)

Article
03/04/2024

Récupère les entrées de palette à partir d’un plan de couche d’index de couleur donné pour un contexte d’appareil spécifié.

Syntaxe

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

Paramètres

unnamedParam1

Type : HDC

Contexte d’appareil d’une fenêtre dont les plans de couche doivent être décrits.

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 à récupérer.

unnamedParam4

Type : int

Nombre d’entrées de palette à récupérer.

unnamedParam5

Type : COLORREF*

Tableau de structures qui contiennent des valeurs de couleur RVB de palette. Le tableau doit contenir au moins autant de structures que spécifié par cEntries.

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 de couche d’index de couleur dans une fenêtre a une palette de taille 2^n, où n est le nombre de plans 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.

Configuration requise

Condition requise	Valeur
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