сообщение BCM_SETIMAGELIST

Назначает список изображений элементу управления "Кнопка". Это сообщение можно отправить явным образом или использовать макрос Button_SetImageList .

Параметры

wParam

Не используется; значение должно быть равно нулю.

lParam

Указатель на структуру BUTTON_IMAGELIST , содержащую сведения о списке изображений.

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

Если сообщение завершается успешно, возвращается значение TRUE. В противном случае возвращается значение FALSE.

Комментарии

Примечание

Чтобы использовать это сообщение, необходимо предоставить манифест, указывающий Comclt32.dll версии 6.0. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.

Список изображений, указанный в элементе himlструктуры BUTTON_IMAGELIST , должен содержать либо одно изображение, которое будет использоваться для всех состояний, либо отдельные изображения для каждого состояния. Следующие состояния определены в vssym32.h.

enum PUSHBUTTONSTATES {
    PBS_NORMAL = 1,
    PBS_HOT = 2,
    PBS_PRESSED = 3,
    PBS_DISABLED = 4,
    PBS_DEFAULTED = 5,
    PBS_STYLUSHOT = 6,
};

Обратите внимание, что PBS_STYLUSHOT используется только на планшетных компьютерах.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Commctrl.h