Función SetDIBColorTable (wingdi.h)

Artículo
03/08/2023

La función SetDIBColorTable establece valores de color RGB (rojo, verde y azul) en un intervalo de entradas de la tabla de colores de la DIB seleccionada actualmente en un contexto de dispositivo especificado.

Sintaxis

UINT SetDIBColorTable(
  [in] HDC           hdc,
  [in] UINT          iStart,
  [in] UINT          cEntries,
  [in] const RGBQUAD *prgbq
);

Parámetros

[in] hdc

Un contexto de dispositivo. Se debe seleccionar una 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 establecer.

[in] cEntries

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

[in] prgbq

Puntero a una matriz de estructuras RGBQUAD que contienen nueva información de color para la tabla de colores de DIB.

Valor devuelto

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

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

Comentarios

Se debe llamar a esta función para establecer la tabla de colores para los DIB que usan 1, 4 o 8 bpp. Miembro BitCount de la estructura de encabezado de información de mapa de bits asociada de un mapa de bits.

La estructura BITMAPINFOHEADER especifica el número de bits por píxel. Los mapas de bits independientes del dispositivo con un valor biBitCount mayor que 8 no tienen una tabla de colores.

El miembro bV5BitCount de la estructura de BITMAPV5HEADER asociada de un mapa de bits especifica el número de bits por píxel. Los mapas de bits independientes del dispositivo con un valor bV5BitCount mayor que 8 no tienen una tabla de colores.

ICM: No se realiza ninguna administración de colores.

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