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 |