Función GetDIBColorTable (wingdi.h)

Artículo
03/08/2023

La función GetDIBColorTable recupera valores de color RGB (rojo, verde y azul) de un intervalo de entradas en la tabla de colores del mapa de bits de la sección DIB que está seleccionado actualmente en un contexto de dispositivo especificado.

Sintaxis

UINT GetDIBColorTable(
  [in]  HDC     hdc,
  [in]  UINT    iStart,
  [in]  UINT    cEntries,
  [out] RGBQUAD *prgbq
);

Parámetros

[in] hdc

Identificador de un contexto de dispositivo. Se debe seleccionar un mapa de bits de sección de DIB en este contexto de dispositivo.

[in] iStart

Índice de tabla de colores de base cero que especifica la primera entrada de tabla de colores que se va a recuperar.

[in] cEntries

Número de entradas de tabla de colores que se van a recuperar.

[out] prgbq

Puntero a un búfer que recibe una matriz de estructuras de datos RGBQUAD que contienen información de color de la tabla de colores DIB. El búfer debe ser lo suficientemente grande como para contener tantas estructuras de datos RGBQUAD como valor de cEntries.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es el número de entradas de la tabla de colores que recupera la función.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Se debe llamar a la función GetDIBColorTable para recuperar la tabla de colores de los mapas de bits de sección DIB que usan 1, 4 o 8 bpp. El miembro biBitCount de una estructura BITMAPINFOHEADER asociada a un mapa de bits especifica el número de bits por píxel. Los mapas de bits de sección DIB con un valor biBitCount mayor que ocho no tienen una tabla de colores, pero tienen máscaras de color asociadas. Llame a la función GetObject para recuperar esas máscaras de color.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll