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

STM_SETIMAGE сообщение

  • Статья

Приложение отправляет сообщение STM_SETIMAGE , чтобы связать новое изображение со статическим элементом управления.

Параметры

wParam

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

Значение Значение
IMAGE_BITMAP
 Растрового изображения.
IMAGE_CURSOR
 Курсор.
IMAGE_ENHMETAFILE
 Расширенный метафайл.
IMAGE_ICON
 Значок.

lParam

Дескриптор изображения для связывания со статическим элементом управления.

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

Возвращаемое значение — это дескриптор изображения, ранее связанного со статическим элементом управления, если таковой имеется; В противном случае значение равно NULL.

Комментарии

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

Тип образа Статический стиль элемента управления
IMAGE_BITMAP SS_BITMAP
IMAGE_CURSOR SS_ICON
IMAGE_ENHMETAFILE SS_ENHMETAFILE
IMAGE_ICON SS_ICON

Важно!

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

В Windows XP, если растровое изображение, переданное в STM_SETIMAGE сообщении, содержит пиксели с ненулевой альфа-версией, статический элемент управления принимает копию растрового изображения. Это скопированное растровое изображение возвращается в следующем STM_SETIMAGE сообщении . Клиентский код может независимо отслеживать растровые изображения, передаваемые в статический элемент управления, но если он не проверка и не освобождает растровые изображения, возвращенные из STM_SETIMAGE сообщений, то растровые изображения будут утечки.

Требования

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

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

STM_GETIMAGE