Visual 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
视觉对象层次结构中的基础视觉对象。
[WebHostHidden]
public ref class Visual : CompositionObject/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[WebHostHidden]
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(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
[WebHostHidden]
class Visual : CompositionObject[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 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(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public class Visual : CompositionObjectPublic Class Visual
Inherits CompositionObject- 继承
- 派生
- 属性
注解
视觉对象撰写和呈现序列化的绘图内容，并构成保留模式视觉系统的基础。 Visual 类支持基本位置和剪裁，并且可以应用 2D 和 3D 转换。 通过子类（如 SpriteVisual 或 ContainerVisual）以及将视觉对象的 Brush 属性设置为 CompositionBrush 子类（如 CompositionColorBrush、 CompositionEffectBrush 或 CompositionSurfaceBrush）提供纯色、图像和具有效果的内容等其他功能。
视觉对象是线程敏捷对象，不绑定到 UI 线程。
可创建动画的属性
可对以下属性进行动画处理。 调用 CompositionObject.StartAnimation 以将 属性与 CompositionAnimation 相关联。
旋转
视觉对象支持两种旋转形式：
轴角
轴角度旋转使用 RotationAngle、 RotationAxis 和 CenterPoint 属性来指定旋转度、要旋转的轴以及要旋转的视觉对象的中心点。
orientation
按方向旋转使用 Orientation 属性指定描述三维空间中方向和旋转的四元数。
属性
| AnchorPoint |
视觉对象上要定位在视觉对象偏移量的点。 值根据视觉对象的大小进行规范化。 可进行动画处理。 |
| BackfaceVisibility |
指定在 3D 转换期间视觉对象的背面是否可见。 |
| BorderMode |
指定如何组合与视觉对象关联的位图和剪辑的边缘，或与此视觉对象关联的子树中的所有视觉对象。 在父视觉对象处设置 BorderMode 将影响子树中的所有子视觉对象，并且可以在每个子视觉对象上选择性地关闭。 |
| CenterPoint |
发生旋转或缩放的点。 可进行动画处理 |
| Clip |
指定视觉对象的剪辑区域。 呈现视觉对象时，仅显示位于剪辑区域内的视觉对象部分，而延伸至剪辑区域之外的任何内容将剪切 (即不显示) 。 |
| Comment |
要与 CompositionObject 关联的字符串。 (继承自 CompositionObject) |
| CompositeMode |
指定视觉对象的位图与屏幕的混合方式。 |
| Compositor |
用于创建此 CompositionObject 的 Compositor。 (继承自 CompositionObject) |
| DispatcherQueue |
获取 CompositionObject 的 DispatcherQueue。 (继承自 CompositionObject) |
| ImplicitAnimations |
附加到此 对象的隐式动画的集合。 (继承自 CompositionObject) |
| IsHitTestVisible |
获取或设置一个值，该值指示根位于此视觉对象的可视化子树是否参与命中测试。 |
| IsPixelSnappingEnabled |
获取或设置一个值，该值指示合成引擎是否将呈现的视觉对象与像素边界对齐。 |
| IsVisible |
指示子视觉对象的视觉对象及其整个子树是否可见。 |
| Offset |
视觉对象相对于其父级的偏移量或根视觉对象相对于承载视觉对象的窗口左上角的偏移量。 可进行动画处理。 |
| Opacity |
视觉对象的不透明度。 可进行动画处理。 不透明度属性确定视觉对象的透明度（如果有），并且是一个介于 0 到 1 的值。 0 表示完全透明，1 表示完全不透明。 不透明度属性为 0 的视觉对象仍存在于树中。 与视觉对象上的其他属性一样，可以使用 Windows、UI 对不透明度进行动画处理。合成动画系统。 |
| Orientation |
描述将应用于视觉对象的 3D 空间中的方向和旋转的四元数。 可进行动画处理。 |
| Parent |
可见对象的父对象。 |
| ParentForTransform |
指定构成此视觉对象的坐标系的视觉对象。 |
| Properties |
与 CompositionObject 关联的属性的集合。 (继承自 CompositionObject) |
| RelativeOffsetAdjustment |
指定视觉对象相对于其父视觉对象大小的偏移量。 |
| RelativeSizeAdjustment |
获取或设置视觉对象相对于其父视觉对象的大小的大小。 |
| RotationAngle |
视觉对象的旋转角度（以弧度为单位）。 可进行动画处理。 |
| RotationAngleInDegrees |
视觉对象的旋转角度（以度为单位）。 可进行动画处理。 |
| RotationAxis |
要围绕视觉对象旋转的轴。 可进行动画处理。 |
| Scale |
要应用于视觉对象的缩放比例。 |
| Size |
视觉对象的宽度和高度。 可进行动画处理。 |
| TransformMatrix |
要应用于视觉对象的转换矩阵。 可进行动画处理。 |
方法
| Close() |
关闭 CompositionObject 并释放系统资源。 (继承自 CompositionObject) |
| Dispose() |
执行与释放或重置非托管资源关联的应用程序定义的任务。 (继承自 CompositionObject) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
定义可进行动画处理的属性。 (继承自 CompositionObject) |
| StartAnimation(String, CompositionAnimation, AnimationController) |
将动画与 对象的指定属性连接，并启动动画。 (继承自 CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
将动画与 对象的指定属性连接，并启动动画。 (继承自 CompositionObject) |
| StartAnimationGroup(ICompositionAnimationBase) |
启动动画组。 使用 CompositionObject 上的 StartAnimationGroup 方法可以启动 CompositionAnimationGroup。 组中的所有动画都将在 对象上同时启动。 (继承自 CompositionObject) |
| StopAnimation(String) |
断开动画与指定属性的连接，并停止动画。 (继承自 CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
停止动画组。 (继承自 CompositionObject) |
| TryGetAnimationController(String) |
返回指定属性上运行的动画的 AnimationController。 (继承自 CompositionObject) |