CompositionVirtualDrawingSurface 类

定义

命名空间:

Microsoft.UI.Composition

表示稀疏分配的位图，这些位图可与视觉对象相关联，以便在可视化树中组合。

[WebHostHidden]
public ref class CompositionVirtualDrawingSurface : CompositionDrawingSurface

/// [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 CompositionVirtualDrawingSurface : CompositionDrawingSurface

[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 CompositionVirtualDrawingSurface : CompositionDrawingSurface

Public Class CompositionVirtualDrawingSurface
Inherits CompositionDrawingSurface

继承

Object Platform::Object IInspectable CompositionObject CompositionDrawingSurface CompositionVirtualDrawingSurface

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

注解

CompositionVirtualDrawingSurface 类似于 CompositionDrawingSurface，只不过图面是稀疏分配的。 可以使用 Win2D (或 D2D) 呈现内容。

虚拟绘图图面设计用于以下场景：应用程序需要定义大量内容，但只要求在给定时间对用户可见一小部分内容。 例如，考虑一个长滚动的文档或网页。 在这种情况下，应用只需绘制用户当前可见的图面部分，并且可以将不可见的绘图部分推迟到以后才可见。

虚拟表面的最大大小为 2^24 (16M) 像素。 由于浮点精度限制（超出该大小）而施加了此限制，这妨碍了所绘制补丁的像素准确对齐。

属性

AlphaMode	绘图图面的 alpha 模式。 (继承自 CompositionDrawingSurface)
Comment	要与 CompositionObject 关联的字符串。 (继承自 CompositionObject)
Compositor	用于创建此 CompositionObject 的 Compositor。 (继承自 CompositionObject)
DispatcherQueue	获取 CompositionObject 的 DispatcherQueue。 (继承自 CompositionObject)
ImplicitAnimations	附加到此 对象的隐式动画的集合。 (继承自 CompositionObject)
PixelFormat	绘图图面的像素格式。 (继承自 CompositionDrawingSurface)
Properties	与 CompositionObject 关联的属性的集合。 (继承自 CompositionObject)
Size	绘图图面的大小。 (继承自 CompositionDrawingSurface)
SizeInt32	绘图图面的大小。 (继承自 CompositionDrawingSurface)

方法

Close()	关闭 CompositionObject 并释放系统资源。 (继承自 CompositionObject)
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。 (继承自 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定义可进行动画处理的属性。 (继承自 CompositionObject)
Resize(SizeInt32)	将绘图图面调整为指定大小。 (继承自 CompositionDrawingSurface)
Scroll(PointInt32)	滚动绘图图面。 (继承自 CompositionDrawingSurface)
Scroll(PointInt32, RectInt32)	滚动绘图图面。 (继承自 CompositionDrawingSurface)
ScrollWithClip(PointInt32, RectInt32)	使用指定的剪裁矩形滚动绘图图面。 (继承自 CompositionDrawingSurface)
ScrollWithClip(PointInt32, RectInt32, RectInt32)	使用指定的剪裁矩形滚动绘图图面。 (继承自 CompositionDrawingSurface)
StartAnimation(String, CompositionAnimation)	将动画与 对象的指定属性连接，并启动动画。 (继承自 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	将动画与 对象的指定属性连接，并启动动画。 (继承自 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	启动动画组。 使用 CompositionObject 上的 StartAnimationGroup 方法可以启动 CompositionAnimationGroup。 组中的所有动画都将在 对象上同时启动。 (继承自 CompositionObject)
StopAnimation(String)	断开动画与指定属性的连接，并停止动画。 (继承自 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止动画组。 (继承自 CompositionObject)
Trim(RectInt32[])	清除之前定义的虚拟绘图图面的某些部分。 清除的区域将再次被视为空区域，并且之前支持它们的视频内存将被回收。
TryGetAnimationController(String)	返回指定属性上运行的动画的 AnimationController。 (继承自 CompositionObject)