Поделиться через


функция ImageList_SetColorTable

Задает таблицу цветов для списка изображений.

Синтаксис

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

Параметры

himl [in]

Тип: HIMAGELIST

Дескриптор списка изображений.

start [in]

Тип: int

Отсчитываемый от нуля индекс таблицы цветов, указывающий первую запись таблицы цветов для задания.

len [in]

Тип: int

Количество записей таблицы цветов, которые нужно задать.

prgb [in]

Тип: RGBQUAD*

Указатель на массив структур lenRGBQUAD , содержащий новые сведения о цвете для таблицы цветов DIB.

Возвращаемое значение

Тип: int

Если функция выполняется успешно, она возвращает количество записей таблицы цветов, заданных функцией . Если функция завершается сбоем, возвращаемое значение меньше или равно нулю.

Комментарии

Таблицы цветов имеют только списки изображений, созданные с флагом ILC_COLOR4 или ILC_COLOR8 . Таблица цветов такого списка изображений обычно настраивается автоматически путем копирования таблицы цветов первого изображения, добавленного в список (например, с помощью функции ImageList_Add ), если это изображение является DIB. Если первое изображение, добавленное в список изображений, не является DIB, таблица цветов палитры полутонов используется для ILC_COLOR8 списков изображений, а таблица цветов VGA используется для ILC_COLOR4.

Требования

Требование Значение
Минимальная версия клиента
Windows Vista [только классические приложения]
Минимальная версия сервера
Windows Server 2003 [только классические приложения]
DLL
Comctl32.dll (версия 3.51 или более поздняя)

См. также раздел

Таблица цветов