Метод IDCompositionVisual::SetContent (dcomp.h)
Задает для свойства Content этого визуального элемента указанное растровое изображение или оболочку окна.
Синтаксис
HRESULT SetContent(
[in, optional] IUnknown *content
);
Параметры
[in, optional] content
Тип: IUnknown*
Объект , который является новым содержимым этого визуального элемента. Этот параметр может принимать значение NULL.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .
Комментарии
Параметр content должен указывать на одно из следующих значений:
- Объект , реализующий интерфейс IDCompositionSurface .
- Объект , реализующий интерфейс IDXGISwapChain1 .
- Объект-оболочка, возвращаемый методом CreateSurfaceFromHandle или CreateSurfaceFromHwnd .
Визуальный элемент может быть связан с растровым объектом или оболочкой окна. Растровое изображение — это цепочка буферов Microsoft DirectX или поверхность Microsoft DirectComposition.
Оболочка окна создается с помощью метода CreateSurfaceFromHwnd и является автономной для растеризации другого окна, которое должно быть окном верхнего уровня или многоуровневым дочерним окном. Оболочка окна концептуально эквивалентна растровому рисунку, представляющее собой размер целевого окна, в котором отрисовывается содержимое окна. Содержимое включает дочерние окна целевого окна (многоуровневые или иные), а также любое содержимое DirectComposition, рисуемое в дочерних окнах.
Оболочка поверхности DirectComposition создается с помощью метода CreateSurfaceFromHandle и является ссылкой на цепочку буферов. Приложение может использовать оболочку поверхности в сценарии между процессами, когда один процесс создает цепочку буферов, а другой связывает точечное изображение с визуальным элементом.
Растровое изображение всегда рисуется в позиции (0,0) относительно системы координат визуального элемента, хотя на систему координат напрямую влияют свойства OffsetX, OffsetY и Transform, а также косвенно преобразования в визуальных элементах-предках. Растровое изображение визуального элемента всегда рисуется за дочерними элементами этого визуального элемента.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | dcomp.h |
| Библиотека | Dcomp.lib |
| DLL | Dcomp.dll |
См. также раздел
IDXGIFactory2::CreateSwapChain1