Partager via


SetDIBColorTable, fonction (wingdi.h)

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

Voir aussi

BITMAPINFOHEADER

Fonctions bitmap

Vue d’ensemble des bitmaps

CreateDIBSection

DIBSECTION

GetDIBColorTable

Getobject

RGBQUAD