función ImageList_SetColorTable

Establece la tabla de colores de una lista de imágenes.

Sintaxis

int ImageList_SetColorTable(
  _In_ HIMAGELIST himl,
  _In_ int        start,
  _In_ int        len,
  _In_ RGBQUAD    *prgb
);

Parámetros

himl [in]

Tipo: HIMAGELIST

Identificador de la lista de imágenes.

start [in]

Tipo: int

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

len [in]

Tipo: int

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

prgb [in]

Tipo: RGBQUAD*

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

Valor devuelto

Tipo: int

Si la función se ejecuta correctamente, devuelve el número de entradas de la tabla de colores establecidas por la función. Si se produce un error en la función, el valor devuelto es menor o igual que cero.

Comentarios

Solo las listas de imágenes creadas con la marca ILC_COLOR4 o ILC_COLOR8 tienen tablas de colores. Normalmente, la tabla de colores de dicha lista de imágenes se establece automáticamente copiando la tabla de colores de la primera imagen agregada a la lista (por ejemplo, a través de la función ImageList_Add ) si esa imagen es una DIB. Si la primera imagen agregada a la lista de imágenes no es una DIB, la tabla de colores de la paleta de media tono se usa para ILC_COLOR8 listas de imágenes y la tabla de colores VGA se usa para ILC_COLOR4.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Archivo DLL	Comctl32.dll (versión 3.51 o posterior)

Consulte también

Tabla de colores