通过

InkSynchronizer 类

  • 参考

定义

命名空间:
Windows.UI.Input.Inking
编辑

管理墨迹输入的同步，并提供将其呈现到通用 Windows 应用的 Direct2D 设备上下文的方法，而不是默认的 InkCanvas 控件。 这需要 IInkD2DRenderer 对象来管理墨迹输入， (查看 复杂墨迹示例) 。

默认情况下，墨迹输入在低延迟后台线程上进行处理，并在绘制时呈现“墨迹未干”。 笔划完成时（抬起笔或手指，或者释放鼠标按钮），笔划将在 UI 线程上进行处理并向 InkCanvas 图层呈现“墨迹已干”（在应用程序内容之上，并且替换未干墨迹）。

通过调用 ActivateCustomDrying（在加载 InkCanvas 之前），应用创建 InkSynchronizer 对象以自定义如何向 SurfaceImageSource 或 VirtualSurfaceImageSource 呈现墨迹已干的笔划墨迹。 例如，笔划墨迹可以光栅化并集成到应用程序内容中，而非作为单独的 InkCanvas 图层。

public ref class InkSynchronizer sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
class InkSynchronizer final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
public sealed class InkSynchronizer
Public NotInheritable Class InkSynchronizer
继承
Object Platform::Object IInspectable InkSynchronizer
属性
ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

方法

BeginDry()

启动对应用的 Direct2D 设备上下文的自定义墨迹输入，而不是默认 InkCanvas 控件。 这需要 IInkD2DRenderer 对象来管理墨迹输入， (查看 复杂墨迹示例) 。

默认情况下，墨迹输入在低延迟后台线程上进行处理，并在绘制时呈现“墨迹未干”。 笔划完成时（抬起笔或手指，或者释放鼠标按钮），笔划将在 UI 线程上进行处理并向 InkCanvas 图层呈现“墨迹已干”（在应用程序内容之上，并且替换未干墨迹）。

通过调用 ActivateCustomDrying（在加载 InkCanvas 之前），应用创建 InkSynchronizer 对象以自定义如何向 SurfaceImageSource 或 VirtualSurfaceImageSource 呈现墨迹已干的笔划墨迹。 例如，笔划墨迹可以光栅化并集成到应用程序内容中，而非作为单独的 InkCanvas 图层。
EndDry()

完成应用的 Direct2D 设备上下文（而不是默认 InkCanvas 控件）的自定义墨迹输入，并通知系统可以删除“湿”墨迹。 这需要 IInkD2DRenderer 对象来管理墨迹输入， (查看 复杂墨迹示例) 。

默认情况下，墨迹输入在低延迟后台线程上进行处理，并在绘制时呈现“墨迹未干”。 笔划完成时（抬起笔或手指，或者释放鼠标按钮），笔划将在 UI 线程上进行处理并向 InkCanvas 图层呈现“墨迹已干”（在应用程序内容之上，并且替换未干墨迹）。

通过调用 ActivateCustomDrying（在加载 InkCanvas 之前），应用创建 InkSynchronizer 对象以自定义如何向 SurfaceImageSource 或 VirtualSurfaceImageSource 呈现墨迹已干的笔划墨迹。 例如，笔划墨迹可以光栅化并集成到应用程序内容中，而非作为单独的 InkCanvas 图层。

适用于

另请参阅