SetDIBColorTable, fonction (wingdi.h)

Article
03/04/2024

La fonction SetDIBColorTable définit les valeurs de couleur RVB (rouge, vert, bleu) dans une plage d’entrées dans la table de couleurs de la DIB actuellement sélectionnée dans un contexte d’appareil spécifié.

Syntaxe

UINT SetDIBColorTable(
  [in] HDC           hdc,
  [in] UINT          iStart,
  [in] UINT          cEntries,
  [in] const RGBQUAD *prgbq
);

Paramètres

[in] hdc

Contexte d’appareil. Une DIB doit être sélectionnée dans ce contexte d’appareil.

[in] iStart

Index de table de couleurs de base zéro qui spécifie la première entrée de table de couleurs à définir.

[in] cEntries

Nombre d’entrées de table de couleurs à définir.

[in] prgbq

Pointeur vers un tableau de structures RGBQUAD contenant de nouvelles informations de couleur pour la table de couleurs de la DIB.

Valeur retournée

Si la fonction réussit, la valeur de retour correspond au nombre d’entrées de table de couleurs que la fonction définit.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Cette fonction doit être appelée pour définir la table de couleurs pour les DIB qui utilisent 1, 4 ou 8 bpp. Membre BitCount de la structure d’en-tête d’informations bitmap associée à une bitmap.

La structure BITMAPINFOHEADER spécifie le nombre de bits par pixel. Les bitmaps indépendantes de l’appareil avec une valeur biBitCount supérieure à 8 n’ont pas de table de couleurs.

Le membre bV5BitCount de la structure de BITMAPV5HEADER associée à une bitmap spécifie le nombre de bits par pixel. Les bitmaps indépendantes de l’appareil dont la valeur bV5BitCount est supérieure à 8 n’ont pas de table de couleurs.

ICM: Aucune gestion des couleurs n’est effectuée.

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 (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll