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