Partager via


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

Voir aussi

BITMAPINFOHEADER

Fonctions bitmap

Vue d’ensemble des bitmaps

CreateDIBSection

DIBSECTION

Getobject

RGBQUAD

SetDIBColorTable