GetDIBColorTable, fonction (wingdi.h)
La fonction GetDIBColorTable récupère les valeurs de couleur RVB (rouge, vert, bleu) à partir d’une plage d’entrées dans la table de couleurs de la bitmap de section DIB actuellement sélectionnée dans un contexte d’appareil spécifié.
Syntaxe
UINT GetDIBColorTable(
[in] HDC hdc,
[in] UINT iStart,
[in] UINT cEntries,
[out] RGBQUAD *prgbq
);
Paramètres
[in] hdc
Handle d'un contexte de périphérique. Une bitmap de section 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 à récupérer.
[in] cEntries
Nombre d’entrées de table de couleurs à récupérer.
[out] prgbq
Pointeur vers une mémoire tampon qui reçoit un tableau de structures de données RGBQUAD contenant des informations de couleur de la table de couleurs DIB. La mémoire tampon doit être suffisamment grande pour contenir autant de structures de données RGBQUAD que la valeur de cEntries.
Valeur retournée
Si la fonction réussit, la valeur de retour correspond au nombre d’entrées de table de couleurs récupérées par la fonction.
Si la fonction échoue, la valeur de retour est égale à zéro.
Remarques
La fonction GetDIBColorTable doit être appelée pour récupérer la table de couleurs pour les bitmaps de section DIB qui utilisent 1, 4 ou 8 bpp. Le membre biBitCount d’une structure BITMAPINFOHEADER associée à une bitmap spécifie le nombre de bits par pixel. Les bitmaps de section DIB avec une valeur biBitCount supérieure à huit n’ont pas de table de couleurs, mais elles ont des masques de couleur associés. Appelez la fonction GetObject pour récupérer ces masques de couleur.
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 |