commctrl.h


ImageList_SetColorTable

Asigna la tabla de colores para una lista de imágenes.

Sintaxis

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

Parámetros

himl
Un manipuladr de la lista de imágenes.
start
Un índice de tabla de color basado en cero que especifica la primera entrada de color en la tabla a asignar.
len
El número de entradas en la tabla de colores a asignar.
prgb
Un puntero a un array de len estructuras RGBQUAD que contiene la información de los nuevos colores para la tabla de colores del DIB.

Valor de retorno

Si la función tiene éxito, devuelve el número de entradas de color asignadas por la función. Si la función falla, el valor de retorno es menor o igual que cero.

Observaciones

Sólo las listas de imágenes creadas con la bandera ILC_COLOR4 o ILC_COLOR8 tienen tablas de color. La tabla de colores de este tipo de listas de imágenes se suele configurar automáticamente mediante la copia de la tabla de colores de la primera imagen añadida a la lista (por ejemplo, a través de la función ImageList_Add) si esa imagen es un DIB. Si la primera imagen añadida a la lista de imágenes no es un DIB, entonces se usa la tabla de colores de la paleta de medio tono para listas de imágenes ILC_COLOR8 y la tabla de colores VGA se usa para listas de imágenes ILC_COLOR4.