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


Метод IDCompositionDevice::CreateVisual (dcomp.h)

Создает новый визуальный объект.

Синтаксис

HRESULT CreateVisual(
  [out] IDCompositionVisual **visual
);

Параметры

[out] visual

Тип: IDCompositionVisual**

Новый визуальный объект. Этот параметр не должен иметь значение NULL.

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

Тип: HRESULT

Если функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .

Комментарии

Новый визуальный объект имеет статическое значение, равное нулю для свойств OffsetX и OffsetY, и NULL для свойств Transform, Clip и Content. Изначально визуальный элемент не приводит к изменению содержимого окна. Визуальный элемент должен быть добавлен как дочерний элемент другого визуального элемента или в качестве корня целевого объекта композиции, прежде чем он может повлиять на внешний вид окна.

Примеры

Пример см. в разделе Создание простого визуального дерева.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header dcomp.h
Библиотека Dcomp.lib
DLL Dcomp.dll

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

IDCompositionDevice

IDCompositionTarget::SetRoot

IDCompositionVisual::AddVisual