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

Метод IImageList2::Replace2 (commoncontrols.h)

  • Статья

Заменяет изображение в списке изображений.

Синтаксис

HRESULT Replace2(
  [in]           int      i,
  [in]           HBITMAP  hbmImage,
  [in, optional] HBITMAP  hbmMask,
  [in, optional] IUnknown *punk,
  [in]           DWORD    dwFlags
);

Параметры

[in] i

Тип: int

Индекс заменяемого изображения.

[in] hbmImage

Тип: HBITMAP

Дескриптор растрового изображения, содержащего изображение.

[in, optional] hbmMask

Тип: HBITMAP

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

[in, optional] punk

Тип: IUnknown*

Указатель на интерфейс IUnknown .

[in] dwFlags

Тип: DWORD

Указывает, как маска применяется к изображению в виде одного или побитового сочетания следующих флагов оформления.

Значение Значение
ILR_DEFAULT
0x0000
 Не используется.
ILR_HORIZONTAL_LEFT
0x0000
 Выравнивание по горизонтали по левому краю.
ILR_HORIZONTAL_CENTER
0x0001
 По горизонтали по центру.
ILR_HORIZONTAL_RIGHT
0x0002
 Выравнивание по горизонтали по правому краю.
ILR_VERTICAL_TOP
0x0000
 Выровнять по вертикали поверх.
ILR_VERTICAL_CENTER
0x0010
 Выровнять по вертикали по центру.
ILR_VERTICAL_BOTTOM
0x0020
 Выравнивание по вертикали по нижней части.
ILR_SCALE_CLIP
0x0000
 Не делать ничего.
ILR_SCALE_ASPECTRATIO
0x0100
 Масштабирование.

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

Тип: HRESULT

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

Требования

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