Surface 触控笔（可在 Microsoft Store 购买）。

针对笔输入优化 Windows 应用，以便为用户同时提供标准的指针设备功能和最佳的 Windows Ink 体验。

注意

本主题重点介绍 Windows Ink 平台。 有关常规指针输入处理（类似于鼠标、触摸和触摸板），请参阅 “处理指针输入”。

在 Windows 应用中使用墨迹

使用 Windows 触控笔和墨迹生成更具吸引力的企业应用

Windows Ink 平台与笔设备一起提供了创建数字手写笔记、绘图和批注的自然方法。 该平台支持将数字化器输入捕获为墨迹数据、生成墨迹数据、管理墨迹数据、将墨迹数据呈现为输出设备上的墨迹笔划，以及通过手写识别将墨迹转换为文本。

除了在用户写入或绘图时捕获笔的基本位置和移动之外，你的应用还可以跟踪和收集整个笔划中使用的不同压力量。 此信息以及笔尖形状、大小和旋转、墨迹颜色和用途（纯墨迹、擦除、突出显示和选择）的设置，使你可以提供与使用笔、铅笔或画笔在纸上书写或绘图非常相似的用户体验。

注意

你的应用还可以支持来自其他基于指针的设备（包括触摸数字化器和鼠标设备）的墨迹输入。 

墨迹平台非常灵活。 它旨在支持各种级别的功能，具体取决于你的要求。

有关 Windows Ink UX 指南，请参阅 墨迹书写控件。

若要添加基本墨迹书写功能，只需将 InkCanvas UWP 平台控件放在应用中的相应页面上即可。

默认情况下， InkCanvas 仅支持笔中的墨迹输入。 输入要么使用颜色和粗细的默认设置（粗细为 2 像素的黑色圆球笔）呈现为墨迹笔划，要么被视为笔划橡皮擦（输入来自橡皮擦尖或用擦除按钮修改的笔尖）。

注意

如果橡皮擦提示或按钮不存在，可以将 InkCanvas 配置为将笔尖的输入作为擦除笔划进行处理。

在此示例中， InkCanvas 覆盖背景图像。

注意

InkCanvas 的默认 Height 和 Width 属性为零，除非它是自动调整其子元素大小的元素的子项，例如 StackPanel 或 Grid 控件。

此系列图像显示此 InkCanvas 控件如何呈现笔输入。

InkCanvas 控件支持的墨迹书写功能由名为 InkPresenter 的代码隐藏对象提供。

对于基本墨迹书写，无需关注 InkPresenter。 但是，若要在 InkCanvas 上自定义和配置墨迹书写行为，必须访问其相应的 InkPresenter 对象。

使用每个 InkCanvas 控件实例化 InkPresenter 对象。

注意

无法直接实例化 InkPresenter。 而是通过 InkCanvas 的 InkPresenter 属性访问它。 

除了提供相应 InkCanvas 控件的所有默认墨迹书写行为外，InkPresenter 还提供了一组全面的 API，用于对笔输入进行额外的笔划自定义和精细管理（标准和修改）。 这包括笔划属性、支持的输入设备类型，以及输入是由对象处理还是传递给应用进行处理。

注意

标准墨迹输入（从笔尖或橡皮擦提示/按钮）未使用辅助硬件功能进行修改，例如笔桶按钮、鼠标右键或类似机制。

默认情况下，仅笔输入支持墨迹。 在这里，我们将 InkPresenter 配置为将笔和鼠标中的输入数据解释为墨迹笔划。 我们还设置了一些用于将笔划呈现到 InkCanvas 的初始墨迹笔划属性。

若要启用鼠标和触摸墨迹书写，请将 InkPresenter 的 InputDeviceTypes 属性设置为所需的 CoreInputDeviceTypes 值的组合。

可以动态设置墨迹笔划属性以适应用户首选项或应用要求。

在这里，我们允许用户从墨迹颜色列表中选择。

然后处理对所选颜色的更改，并相应地更新墨迹笔划属性。

这些图像显示了 InkPresenter 如何处理和自定义笔输入。

具有默认黑色墨迹笔划的 InkCanvas。

用户选择红色墨迹笔划的 InkCanvas。

若要提供墨迹书写和擦除以外的功能（如笔划选择），你的应用必须标识 InkPresenter 的特定输入，以便通过未经处理的应用进行处理。

默认情况下， InkPresenter 将所有输入都作为墨迹笔划或擦除笔划进行处理，包括由辅助硬件提供（如笔桶按钮、鼠标右键或类似）修改的输入。 但是，用户通常期望使用这些辅助功能或修改行为。

在某些情况下，你可能还需要公开没有辅助功能（通常不与笔尖关联的功能）、其他输入设备类型或基于应用 UI 中的用户选择的某种类型的修改行为来公开笔的其他功能。

为了支持此功能， 可以将 InkPresenter 配置为保留未处理的特定输入。 然后，此未处理的输入将传递到应用进行处理。

Windows Ink 平台不提供对需要修改输入的操作的内置支持，例如笔划选择。 若要支持此类功能，必须在应用中提供自定义解决方案。

下面的代码示例（所有代码都在 MainPage.xaml 和 MainPage.xaml.cs 文件中）逐步介绍如何在使用笔桶按钮（或鼠标右键）修改输入时启用笔划选择。

首先，我们在 MainPage.xaml 中设置 UI。

在这里，我们添加画布（在 InkCanvas 下方）绘制选择笔划。 使用单独的层绘制选择笔划会使 InkCanvas 及其内容保持不变。

在MainPage.xaml.cs中，我们声明了几个全局变量来保留对所选 UI 的各个方面的引用。 具体而言，选择套索笔划和突出显示所选笔划的边界矩形。

接下来，我们将 InkPresenter 配置为将笔和鼠标中的输入数据解释为墨迹笔划，并设置一些用于将笔划呈现到 InkCanvas 的初始墨迹笔划属性。

最重要的是，我们使用 InkPresenter 的 InputProcessingConfiguration 属性来指示应用应处理任何修改的输入。 通过分配 InputProcessingConfiguration.RightDragAction 值 InkInputRightDragAction.LeaveUnprocessed 来指定修改的输入。 设置此值后， InkPresenter 将传递到 InkUnprocessedInput 类，这是一组指针事件供你处理。

我们为 InkPresenter 传递的未处理的 PointerPressed、PointerMoved 和 PointerReleased 事件分配侦听器。 所有选择功能都在这些事件的处理程序中实现。

最后，为 InkPresenter 的 StrokeStarted 和 StrokesErased 事件分配侦听器。 如果启动新笔划或清除现有笔划，我们将使用这些事件的处理程序来清理选择 UI。

然后，为 InkPresenter 传递的未处理的 PointerPressed、PointerMoved 和 PointerReleased 事件定义处理程序。

所有选择功能都在这些处理程序中实现，包括套索笔划和边界矩形。

为了结束 PointerReleased 事件处理程序，我们清除所有内容（套索笔划）的选择层，然后在套索区域包含的墨迹笔划周围绘制单个边界矩形。

最后，我们定义 StrokeStarted 和 StrokesErased InkPresenter 事件的处理程序。

这两者只需调用相同的清理函数，以在检测到新笔划时清除当前选择。

下面是在启动新笔划或擦除现有笔划时从选择画布中删除所有选择 UI 的函数。

默认情况下，墨迹输入在低延迟后台线程上进行处理，并在绘制时呈现为“湿”。 完成笔划（笔或手指抬起或松开鼠标按钮）时，笔划将在 UI 线程上进行处理，并将“干”渲染到 InkCanvas 层（替换应用程序内容上方的湿墨迹）。

你可以重写此默认行为，并通过“自定义干燥”湿墨笔划完全控制墨迹书写体验。 虽然默认行为通常足以用于大多数应用程序，但在某些情况下可能需要自定义干燥，其中包括：

自定义干燥需要 IInkD2DRenderer 对象来管理墨迹输入，并将其呈现到通用 Windows 应用的 Direct2D 设备上下文，而不是默认的 InkCanvas 控件。

通过调用 ActivateCustomDrying（在加载 InkCanvas 之前），应用会创建 InkSynchronizer 对象，以自定义墨迹笔划如何干化到 SurfaceImageSource 或 VirtualSurfaceImageSource。

SurfaceImageSource 和 VirtualSurfaceImageSource 都为应用提供了一个 DirectX 共享图面，用于绘制和撰写应用程序内容，尽管 VSIS 提供了一个比屏幕更大的虚拟图面，用于执行平移和缩放。 由于这些图面的视觉更新与 XAML UI 线程同步，在向其中的任意一个呈现墨迹时，可以同时从 InkCanvas 中删除未干墨迹。

还可以将干墨自定义为 SwapChainPanel，但无法保证与 UI 线程同步，并且当墨迹呈现到 SwapChainPanel 以及从 InkCanvas 中删除墨迹时，可能存在延迟。

有关此功能的完整示例，请参阅 复杂墨迹示例。

注意

自定义干墨和 InkToolbar 如果应用修改了 InkPresenter 的自定义干燥渲染行为，则渲染的墨迹笔划不再可用于 InkToolbar，并且 InkToolbar 的内置擦除命令无法按预期工作。 要提供擦除功能，必须处理所有指针事件、对每个笔划执行命中测试，并重写内置的“擦除所有墨迹”命令。