Метод IDCompositionVisual::SetTransformParent (dcomp.h)

Задает свойство TransformParent этого визуального элемента. Свойство TransformParent устанавливает систему координат, относительно которой состоит этот визуальный элемент.

Синтаксис

HRESULT SetTransformParent(
  [in, optional] IDCompositionVisual *visual
);

Параметры

[in, optional] visual

Тип: IDCompositionVisual*

Новый визуальный элемент, который устанавливает базовую систему координат для этого визуального элемента. Этот параметр может принимать значение NULL.

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

Тип: HRESULT

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

Комментарии

Система координат визуального элемента изменяется свойствами OffsetX, OffsetY и Transform. Как правило, эти свойства определяют систему координат визуального элемента относительно его непосредственного родительского элемента. Этот метод задает визуальный элемент, относительно которого основана система координат для этого визуального элемента. Указанный визуальный элемент должен быть предком текущего визуального элемента. Если он не является предком, система координат основана на непосредственном родительском элементе этого визуального элемента, как если бы свойству TransformParent было присвоено значение NULL. Так как визуальные элементы могут быть повторно преобразованы, это свойство может вступает в силу снова, если указанный визуальный элемент становится предком целевого визуального элемента с помощью операции повторного родителя.

Если параметр визуального элемента имеет значение NULL, система координат всегда преобразуется относительно непосредственного родительского элемента визуального элемента. Это поведение по умолчанию, если этот метод не используется.

Этот метод завершается ошибкой, если параметр визуального элемента является недопустимым указателем или если он не был создан тем же интерфейсом IDCompositionDevice , что и этот визуальный элемент. Интерфейс не может быть пользовательской реализацией; С этим методом можно использовать только интерфейсы, созданные Microsoft DirectComposition.

Требования

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

IDCompositionVisual