Visual 类

定义

视觉对象层次结构中的基视觉对象。

public ref class Visual : CompositionObject
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
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.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public 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 IInspectable CompositionObject Visual
派生
属性

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

视觉对象撰写和呈现序列化的绘图内容,并构成保留模式视觉系统的基础。 Visual 类支持基本位置和剪裁,并且可以应用 2D 和 3D 转换。 通过子类(如 SpriteVisualContainerVisual)以及将视觉对象的 Brush 属性设置为 CompositionBrush 子类(如 CompositionColorBrushCompositionEffectBrushCompositionSurfaceBrush)提供纯色、图像和具有效果的内容等其他功能。

视觉对象是线程敏捷对象,不绑定到 UI 线程。

可创建动画的属性

可对以下属性进行动画处理。 调用 CompositionObject.StartAnimation 以将 属性与 CompositionAnimation 相关联。

旋转

视觉对象支持两种旋转形式:

  • 轴角

    轴角度旋转使用 RotationAngleRotationAxisCenterPoint 属性来指定旋转度、要旋转的轴和要旋转的视觉对象的中心点。

  • orientation

    按方向旋转使用 Orientation 属性指定描述三维空间中方向和旋转的四元数。

版本历史记录

Windows 版本 SDK 版本 增值
1703 15063 ParentForTransform
1703 15063 RelativeOffsetAdjustment
1703 15063 RelativeSizeAdjustment

属性

AnchorPoint

视觉对象上要定位在视觉对象偏移量的点。 值根据视觉对象的大小进行规范化。 可进行动画处理。

BackfaceVisibility

指定在 3D 转换期间视觉对象的背面是否可见。

BorderMode

指定如何组合与视觉对象关联的位图和剪辑的边缘,或与此视觉对象关联的子树中的所有视觉对象。 在父视觉对象处设置 BorderMode 将影响子树中的所有子视觉对象,并且可以在每个子视觉对象上选择性地关闭。

CenterPoint

发生旋转或缩放的点。 可进行动画处理

Clip

指定视觉对象的剪辑区域。 呈现视觉对象时,仅显示位于剪裁区域内的视觉对象部分,而延伸至剪辑区域之外的任何内容将剪裁 (即不显示) 。

Comment

要与 CompositionObject 关联的字符串。

(继承自 CompositionObject)
CompositeMode

指定视觉对象的位图与屏幕的混合方式。

Compositor

用于创建此 CompositionObjectCompositor

(继承自 CompositionObject)
Dispatcher

CompositionObject 的调度程序。

(继承自 CompositionObject)
DispatcherQueue

获取 CompostionObject 的 DispatcherQueue

(继承自 CompositionObject)
ImplicitAnimations

附加到此 对象的隐式动画的集合。

(继承自 CompositionObject)
IsHitTestVisible

获取或设置一个值,该值指示根位于此视觉对象的可视化子树是否参与命中测试。

IsPixelSnappingEnabled

获取或设置一个值,该值指示合成引擎是否将呈现的视觉对象与像素边界对齐。

IsVisible

指示子视觉对象的视觉对象及其整个子树是否可见。

Offset

视觉对象相对于其父级的偏移量或根视觉对象相对于承载视觉对象的窗口左上角的偏移量。 可进行动画处理。

Opacity

视觉对象的不透明度。 可进行动画处理。

不透明度属性确定视觉对象的透明度(如果有),并且是一个介于 0 到 1 的值。 0 表示完全透明,1 表示完全不透明。 不透明度属性为 0 的视觉对象仍存在于树中。 与视觉对象上的其他属性一样,Opacity 可以使用 Windows、UI 进行动画处理。合成动画系统。

Orientation

描述将应用于视觉对象的 3D 空间中的方向和旋转的四元数。 可进行动画处理。

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)

启动动画组。

使用 CompositionObject 上的 StartAnimationGroup 方法可以启动 CompositionAnimationGroup。 组中的所有动画都将在 对象上同时启动。

(继承自 CompositionObject)
StopAnimation(String)

断开动画与指定属性的连接,并停止动画。

(继承自 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

停止动画组。

(继承自 CompositionObject)
TryGetAnimationController(String)

返回指定属性上运行的动画的 AnimationController。

(继承自 CompositionObject)

适用于

另请参阅