Метод IUIImageFromBitmap::CreateImage (uiribbon.h)
Создает объект IUIImage из растрового изображения.
Синтаксис
HRESULT CreateImage(
[in] HBITMAP bitmap,
[in] UI_OWNERSHIP options,
[out] IUIImage **image
);
Параметры
[in] bitmap
Тип: HBITMAP
Дескриптор растрового изображения, содержащего изображение.
[in] options
Тип: UI_OWNERSHIP
Условия владения, при которых создается образ.
| Значение | Значение |
|---|---|
| UI_OWNERSHIP_TRANSFER | Если UI_OWNERSHIP_TRANSFER указан в качестве значения параметров, платформа ленты владеет дескриптором растрового изображения (HBITMAP) через объект IUIImage и освобождает его, когда платформа больше не требуется.
Примечание Этот параметр не позволяет ведущему приложению ленты безопасно ссылаться на тот же HBITMAP в другом месте пользовательского интерфейса приложения.
|
| UI_OWNERSHIP_COPY | Если UI_OWNERSHIP_COPY указан в качестве значения параметров, ведущее приложение владеет HBITMAP и может ссылаться на ту же HBITMAP для использования в других местах пользовательского интерфейса.
Примечание Этот параметр возлагает ответственность за освобождение HBITMAP в ведущем приложении.
|
[out] image
Тип: IUIImage**
При возврате этим методом содержит адрес переменной указателя, которая получает объект IUIImage .
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Этот фабричный метод полезен, когда приложение динамически создает ресурс изображения и хочет передать новый HBITMAP на ленту, например, при загрузке переносимой сетевой графики (PNG) через компонент образов Windows (WIC) или с помощью CreateDIBSection для создания изображения для нового стиля в коллекции стилей.
Этот метод также полезен для приложений, которым требуется уже существующее растровое изображение, которое не было отрисовлено лентой устаревшим, например устаревшая полоса изображений панели инструментов.
Укажите UI_OWNERSHIP_COPY в качестве значения для параметров , если лента реализуется в существующем приложении и требуется минимальное изменение кода. Этот метод использует дополнительную память для дополнительного изображения.
Укажите UI_OWNERSHIP_TRANSFER в качестве значения для параметров , чтобы свести к минимуму использование памяти.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | uiribbon.h |
| DLL | Mshtml.dll |