Función SetDIBColorTable (wingdi.h)
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 |