Метод IDCompositionVisual::SetOffsetX(float) (dcomp.h)
Изменяет значение свойства OffsetX этого визуального элемента. Свойство OffsetX задает новое смещение визуального элемента вдоль оси X относительно родительского визуального элемента.
Синтаксис
HRESULT SetOffsetX(
[in] float offsetX
);
Параметры
[in] offsetX
Тип: float
Новое смещение визуального элемента вдоль оси X в пикселях.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .
Комментарии
Этот метод завершается ошибкой, если параметр offsetX имеет значение NaN, положительная бесконечность или отрицательная бесконечность.
Изменение свойства OffsetX визуального элемента преобразует систему координат всего визуального поддеревья, которое коренится в этом визуальном элементе. Если задано свойство Клип этого визуального элемента, прямоугольник клипа также преобразуется.
Преобразование, заданное свойством Transform, применяется после свойства OffsetX. Другими словами, результат задания свойств Transform и OffsetX такой же, как и для свойства Transform объекта группы преобразования, где первым членом группы является объект IDCompositionTranslateTransform , имеющий то же значение OffsetX, что и offsetX. Однако по возможности следует использовать IDCompositionVisual::SetOffsetX , так как это немного быстрее.
Если для свойств OffsetX и OffsetY задано значение 0, а для свойства Transform задано значение NULL, система координат визуального элемента будет такая же, как и у его родительского элемента.
Если свойство OffsetX было ранее анимировано, этот метод удаляет анимацию и присваивает свойству указанное статическое значение.
Примеры
Пример см. в статье Создание простого визуального дерева.
Требования
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | dcomp.h |
| Библиотека | Dcomp.lib |
| DLL | Dcomp.dll |