CompositionVirtualDrawingSurface 类

定义

命名空间:

Windows.UI.Composition

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

public ref class CompositionVirtualDrawingSurface : CompositionDrawingSurface

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionVirtualDrawingSurface : CompositionDrawingSurface

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class CompositionVirtualDrawingSurface : CompositionDrawingSurface

Public Class CompositionVirtualDrawingSurface
Inherits CompositionDrawingSurface

继承

Object Platform::Object IInspectable CompositionObject CompositionDrawingSurface CompositionVirtualDrawingSurface

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Creators Update (在 10.0.15063.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v4.0 中引入)

注解

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

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

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

属性

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

方法

Close()	关闭 CompositionObject 并释放系统资源。 (继承自 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	连接和动画。 (继承自 CompositionObject)
DisconnectAnimation(String)	断开动画的连接。 (继承自 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)