Метод IDCompositionTarget::SetRoot (dcomp.h)
Задает визуальный объект в качестве нового корневого объекта визуального дерева.
Синтаксис
HRESULT SetRoot(
[in, optional] IDCompositionVisual *visual
);
Параметры
[in, optional] visual
Тип: IDCompositionVisual*
Визуальный объект, который является новым корнем этого визуального дерева. Этот параметр может принимать значение NULL.
Возвращаемое значение
Тип: HRESULT
Если функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .
Комментарии
Визуальный элемент может быть корнем одного визуального дерева или дочерним элементом другого визуального элемента, но он не может одновременно быть одновременно. Этот метод завершается ошибкой, если параметр визуального элемента уже является корнем другого визуального дерева или является дочерним элементом другого визуального элемента.
Если визуальный элемент имеет значение NULL, визуальное дерево будет пустым. Если был предыдущий корневой визуальный элемент, отличный от NULL, этот визуальный элемент становится доступным для использования в качестве корня другого визуального дерева или в качестве дочернего элемента другого визуального элемента.
Примеры
Пример см. в разделе Создание простого визуального дерева.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | dcomp.h |
| Библиотека | Dcomp.lib |
| DLL | Dcomp.dll |