GetDIBColorTable, fonction (wingdi.h)

Article
03/04/2024

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