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


Метод IImageList::SetBkColor (commoncontrols.h)

Задает цвет фона для списка изображений. Этот метод работает только при добавлении значка в список изображений или использовании метода IImageList::AddMasked для добавления черно-белого растрового изображения. Без маски рисуется все изображение, а цвет фона не виден.

Синтаксис

HRESULT SetBkColor(
  [in]  COLORREF clrBk,
  [out] COLORREF *pclr
);

Параметры

[in] clrBk

Тип: COLORREF

Задается цвет фона. Если для этого параметра задано значение CLR_NONE, изображения рисуется прозрачно с помощью маски.

[out] pclr

Тип: COLORREF*

Указатель на объект COLORREF , содержащий предыдущий цвет фона при возврате в случае успешного выполнения, или CLR_NONE в противном случае.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Чтобы использовать IImageList::SetBkColor, укажите в манифесте Comctl32.dll версии 6. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.

Требования

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