Visual Класс

Определение

Пространство имен:

Windows.UI.Composition

Базовый визуальный объект в визуальной иерархии.

public ref class Visual : CompositionObject

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
class Visual : CompositionObject

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
public class Visual : CompositionObject

Public Class Visual
Inherits CompositionObject

Наследование

Object Platform::Object IInspectable CompositionObject Visual

Производный

Windows.UI.Composition.ContainerVisual

Windows.UI.Composition.DelegatedInkTrailVisual

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Визуальные объекты составляют и отрисовывают сериализованное содержимое документа и составляют основу визуальной системы в сохраненном режиме. Класс Visual поддерживает базовое положение и обрезку, а также может применять к ним 2D- и трехмерные преобразования. Дополнительные функции, такие как сплошные цвета, изображения и содержимое с эффектами, предоставляются с помощью таких подклассов, как SpriteVisual или ContainerVisual, а также путем установки свойства Brush визуального элемента в качестве подклассов CompositionBrush, таких как CompositionColorBrush, CompositionEffectBrush или CompositionSurfaceBrush.

Визуальные объекты отличаются гибкостью потока и не привязаны к потоку пользовательского интерфейса.

Анимируемые свойства

Следующие свойства можно анимировать. Вызовите CompositionObject.StartAnimation , чтобы связать свойство с CompositionAnimation.

• Размер
• Offset
• Непрозрачность
• Ориентация
• CenterPoint (Центральная точка)
• RotationAngle (Угол поворота)
• RotationAngleInDegrees (Угол поворота в градусах)
• RotationAxis (Ось поворота)
• TransformMatrix

Поворот

Визуальный элемент поддерживает две формы поворота:

• Угол оси

  Вращение по оси использует свойства RotationAngle, RotationAxis и CenterPoint , чтобы указать поворот в градусах, по какой оси вращаться, а также центральную точку визуального элемента для вращения.

• orientation

  Вращение по ориентации использует свойство Orientation для указания кватерниона, описывающего ориентацию и поворот в трехмерном пространстве.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1703	15063	ParentForTransform
1703	15063	RelativeOffsetAdjustment
1703	15063	RelativeSizeAdjustment

Свойства

AnchorPoint	Точка визуального элемента, расположенная по смещению визуального элемента. Значение нормализуется относительно размера визуального элемента. Анимация.
BackfaceVisibility	Указывает, должна ли отображаться задняя часть визуального элемента во время трехмерного преобразования.
BorderMode	Указывает способ создания краев растровых изображений и клипов, связанных с визуальным элементом или со всеми визуальными элементами в поддереве, корнями которых является этот визуальный элемент. Установка BorderMode в родительском визуальном элементе повлияет на все дочерние визуальные элементы в поддереве и может быть выборочно отключена в каждом дочернем визуальном элементе.
CenterPoint	Точка, о которой происходит поворот или масштабирование. Анимация
Clip	Указывает область обрезки для визуального элемента. При отрисовки визуального элемента отображается только часть визуального элемента, которая находится внутри области обрезки, в то время как любое содержимое, которое выходит за пределы области отсечения, обрезается (т. е. не отображается).
Comment	Строка, связанная с CompositionObject. (Унаследовано от CompositionObject)
CompositeMode	Указывает способ смешивания растрового изображения визуального элемента с экраном.
Compositor	Составитель, используемый для создания этого объекта CompositionObject. (Унаследовано от CompositionObject)
Dispatcher	Диспетчер для CompositionObject. (Унаследовано от CompositionObject)
DispatcherQueue	Возвращает dispatcherQueue для объекта CompostionObject. (Унаследовано от CompositionObject)
ImplicitAnimations	Коллекция неявных анимаций, присоединенных к этому объекту. (Унаследовано от CompositionObject)
IsHitTestVisible	Возвращает или задает значение, указывающее, участвует ли визуальное вложенное дерево в этом визуальном элементе в проверке попадания.
IsPixelSnappingEnabled	Возвращает или задает значение, указывающее, выравнивает ли обработчик композиции отображаемый визуальный элемент с границой пикселя.
IsVisible	Указывает, видим ли визуальный элемент и все его поддерево дочерних визуальных элементов.
Offset	Смещение визуального элемента относительно его родительского элемента или для корневого визуального элемента смещение относительно левого верхнего угла окна, в котором размещен визуальный элемент. Анимация.
Opacity	Прозрачность визуального элемента. Анимация. Свойство непрозрачности определяет прозрачность (если таковой имеется) визуального элемента и является значением от 0 до 1. 0 является полностью прозрачным, а 1 — полностью непрозрачным. Визуальный элемент со свойством Opacity 0 по-прежнему присутствует в дереве. Как и другие свойства визуального элемента, Opacity можно анимировать с помощью windows,ui. Система анимации композиции.
Orientation	Кватернион, описывающий ориентацию и поворот в трехмерном пространстве, которые будут применены к визуальному элементу. Анимация.
Parent	Родительский объект визуального объекта.
ParentForTransform	Визуальный элемент, указывающий систему координат, в которой состоит этот визуальный элемент.
Properties	Коллекция свойств, связанных с CompositionObject. (Унаследовано от CompositionObject)
RelativeOffsetAdjustment	Задает смещение визуального элемента относительно размера его родительского визуального элемента.
RelativeSizeAdjustment	Возвращает или задает размер визуального элемента относительно размера его родительского визуального элемента.
RotationAngle	Угол поворота в радианах визуального элемента. Анимация.
RotationAngleInDegrees	Угол поворота визуального элемента в градусах. Анимация.
RotationAxis	Ось для поворота визуального элемента. Анимация.
Scale	Масштаб, применяемый к визуальному элементу.
Size	Ширина и высота визуального элемента. Анимация.
TransformMatrix	Матрица преобразования, применяемая к визуальному элементу. Анимация.

Методы

Close()	Закрывает объект CompositionObject и освобождает системные ресурсы. (Унаследовано от CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Соединения и анимация. (Унаследовано от CompositionObject)
DisconnectAnimation(String)	Отключает анимацию. (Унаследовано от CompositionObject)
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Определяет свойство, которое можно анимировать. (Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation)	Подключает анимацию к указанному свойству объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Подключает анимацию к указанному свойству объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Запускает группу анимации. Метод StartAnimationGroup в CompositionObject позволяет запустить CompositionAnimationGroup. Все анимации в группе будут запущены одновременно для объекта . (Унаследовано от CompositionObject)
StopAnimation(String)	Отключает анимацию от указанного свойства и останавливает анимацию. (Унаследовано от CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Останавливает группу анимации. (Унаследовано от CompositionObject)
TryGetAnimationController(String)	Возвращает AnimationController для анимации, выполняемой с указанным свойством. (Унаследовано от CompositionObject)

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

• CompositionObject
• IClosable
• Обзор визуального дерева композиции
• Пример визуального элемента композиции без платформы (Windows 10)