Windows.UI.Input.Inking 命名空间

为Windows Ink应用提供输入、处理和管理支持。 这包括：

• 绘制墨迹笔划。
• 捕获笔划。
• 呈现笔划。
• 选择笔划。
• 正在删除笔划。
• 保存和加载笔划。
• 通过手写识别将笔划转换为文本。
• 从剪贴板复制和粘贴笔划。
• 命中测试 (或笔划目标) 。

类

InkDrawingAttributes	提供与 InkStroke 的绘图关联的属性。
InkDrawingAttributesPencilProperties	提供一组静态 InkDrawingAttributes 属性，用于在 InkCanvas 上呈现铅笔划。 通过调用 InkDrawingAttributes.CreateForPencil 并访问 InkDrawingAttributes.PencilProperties 获取此类的实例。
InkInputConfiguration	管理哪些类型的辅助输入可由 InkPresenter 对象处理。
InkInputProcessingConfiguration	管理 InkPresenter 对象处理输入的方式。
InkManager	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 管理输入、操作和处理 (包括一个或多个 InkStroke 对象的手写识别) 。
InkModelerAttributes	管理 InkPresenter 对象可以处理哪些类型的墨迹建模器属性。
InkPoint	为 用于构造 InkStroke 的单一点提供原始输入数据。
InkPresenter	提供属性、方法和事件，用于管理墨迹输入的输入、处理和呈现， (InkCanvas 控件的标准和修改) 。
InkPresenterProtractor	表示一个可视模具，以绘制弧线和曲线的绘制器形式，在 InkCanvas 上显示为半透明覆盖。 模具可转换墨迹笔划的呈现方式： 如果笔尖在距离阈值 (排水沟) ，它会将墨迹笔划贴靠到模具边缘。 它充当掩码，并阻止在模具遮挡的区域内绘制墨迹笔划。 InkPresenterRuler 可以编程方式和用户操作。 它还使用 InkCanvas 进行缩放和翻译。
InkPresenterRuler	表示用于绘制直线的直规则形式的可视模具，在 InkCanvas 上显示为半透明覆盖。 模具可转换墨迹笔划的呈现方式： 如果笔尖在距离阈值 (排水沟) ，它会将墨迹笔划贴靠到模具边缘。 它充当掩码，并阻止在模具遮挡的区域内绘制墨迹笔划。 InkPresenterRuler 可以编程方式和用户操作。 它还使用 InkCanvas 进行缩放和翻译。
InkRecognitionResult	提供用于管理 InkStroke 手写识别数据的属性和方法。 针对 InkRecognizer 检测到的每个单词生成识别结果。
InkRecognizer	管理手写识别的各个方面。
InkRecognizerContainer	提供用于管理用于手写识别的一个或多个 InkRecognizer 对象的属性和方法。 如果识别引擎在系统上不可用，InkRecognizerContainer 为 null。
InkStroke	单个墨迹笔划，包括用于笔划最终呈现的贝塞尔曲线参数。
InkStrokeBuilder	从原始指针输入生成笔划。 注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 使用 CreateStrokeFromInkPoints 和 SetDefaultDrawingAttributes 以编程方式为 InkPresenter 生成笔划。
InkStrokeContainer	提供用于存储和管理 InkPresenter 呈现的 InkStroke 对象的集合的属性和方法。 对笔划容器中任何墨迹笔划所做的修改将立即呈现到与 InkPresenter 关联的绘图图面。
InkStrokeInput	为与 InkPresenter 对象关联的 StrokeInput 提供属性和事件。
InkStrokeRenderingSegment	完整墨迹笔划的单个段。 单个段由一个起点、一个终点和两个贝塞尔控制点组成。 但是，对于构成笔划的一系列段，上一段的最后一点是当前段的第一个点。 这意味着只需要每个段的终点来表示完整的笔划。 每个笔划都是 InkStrokeRenderingSegment 对象的向量，第一个段由单个起点标识，其余所有段由一个终点和两个 Bezier 控制点标识。
InkStrokesCollectedEventArgs	包含与 InkCanvas 控件关联的 InkPresenter 的 StrokesCollected 事件事件数据。 默认情况下，墨迹笔划在低延迟的后台线程上进行处理，并在绘制时呈现湿笔划。 笔划 (笔或手指抬起，或者鼠标按钮) 松开时，笔划会在 UI 线程上进行处理，并干涸地呈现到应用程序内容) 上方的 InkCanvas 层 (。 如果 UI 线程正忙，当线程可用时，可能会处理多个墨迹笔划， (收集) 。 在加载 InkCanvas 之前，可以通过调用 ActivateCustomDrying 方法重写此行为。
InkStrokesErasedEventArgs	包含与 InkCanvas 控件关联的 InkPresenter 的 StrokesErased 事件的事件数据。 默认情况下，墨迹笔划数据和呈现完全由 InkCanvas 控件管理。 但是，在加载 InkCanvas 之前，可以通过调用 ActivateCustomDrying 方法重写此行为。
InkSynchronizer	管理墨迹输入的同步，并提供将其呈现到通用 Windows 应用的 Direct2D 设备上下文的方法，而不是默认的 InkCanvas 控件。 这需要 IInkD2DRenderer 对象来管理墨迹输入， (查看 复杂墨迹示例) 。 默认情况下，墨迹输入在低延迟后台线程上进行处理，并在绘制时呈现“墨迹未干”。 笔划完成时（抬起笔或手指，或者释放鼠标按钮），笔划将在 UI 线程上进行处理并向 InkCanvas 图层呈现“墨迹已干”（在应用程序内容之上，并且替换未干墨迹）。 通过调用 ActivateCustomDrying（在加载 InkCanvas 之前），应用创建 InkSynchronizer 对象以自定义如何向 SurfaceImageSource 或 VirtualSurfaceImageSource 呈现墨迹已干的笔划墨迹。 例如，笔划墨迹可以光栅化并集成到应用程序内容中，而非作为单独的 InkCanvas 图层。
InkUnprocessedInput	提供用于从 InkCanvas 控件自定义处理墨迹数据的属性和事件。 InkPresenter 不处理数据。 使用 InkInputProcessingConfiguration 将要传递的数据标识为 UnprocessedInput。
PenAndInkSettings	) 启用 HandwritingView 时，提供对与在文本控件中接受墨迹并将其转换为文本输入相关的用户设置的访问 (。

接口

IInkPointFactory	定义类型的实现，该类型生成 用于构造InkStroke 的 InkPoint 对象。
IInkPresenterRulerFactory	定义类型的实现，该类型生成用于构造 InkPresenter 的 InkPresenterRuler 对象。
IInkPresenterStencil	表示在 InkCanvas 上显示为半透明覆盖的可视模具。 模具可转换墨迹笔划的呈现方式： 如果笔尖在距离阈值 (排水沟) ，它会将墨迹笔划贴靠到模具边缘。 它充当掩码，并阻止在模具遮挡的区域内绘制墨迹笔划。 可以编程方式和用户操作模具。 它还使用 InkCanvas 进行缩放和翻译。
IInkRecognizerContainer	表示一个或多个 InkRecognizer 对象。
IInkStrokeContainer	表示 InkPresenter 呈现的 InkStroke 对象的集合的管理器。 对笔划容器中任何墨迹笔划所做的修改将立即呈现到与 InkPresenter 关联的绘图图面。

枚举

HandwritingLineHeight	指定在文本控件中使用墨迹输入文本时可用的手写空间， (启用 HandwritingView) 。
InkDrawingAttributesKind	指定与 InkStroke 关联的 InkDrawingAttributes 的类型。
InkHighContrastAdjustment	指定当系统 (处于高对比度模式时 ，InkPresenter 对象如何处理来自关联 InkCanvas 控件的标准输入和修改) 。
InkInputProcessingMode	指定 InkPresenter 对象如何解释其关联的 InkCanvas 控件的 输入。 默认情况下，输入作为标准墨迹或擦除笔划进行处理，也可以将其作为 UnprocessedInput 传递到应用进行自定义处理。
InkInputRightDragAction	指定 InkPresenter 对象如何处理来自笔管按钮、笔橡皮擦笔尖、鼠标右键或类似的辅助输入。 默认情况下，此辅助输入作为主输入进行处理，并呈现为 InkStroke (请参阅注释) 。
InkManipulationMode	指定墨迹输入的模式。
InkPersistenceFormat	指定用于保存墨迹输入的格式。
InkPresenterPredefinedConfiguration	指定一个或多个接触点的墨迹书写行为。 与 SetPredefinedConfiguration 一起使用。
InkPresenterStencilKind	指定可在 InkCanvas 上显示的模具类型。
InkRecognitionTarget	指示要在手写识别中包含哪些笔划。
PenHandedness	标识首选书写手，由用户在“设置”-“设备”->>“笔 & Windows Ink”->“选择使用哪种手写”中指定。
PenTipShape	标识 笔尖的形状。

另请参阅

• 笔和触笔交互
• 入门：在 UWP 应用中支持墨迹
• 墨迹分析示例（基本）(C#)
• 墨迹手写识别示例 (C#)
• 保存并从墨迹序列化格式 (ISF) 文件加载笔划墨迹
• 保存并从剪贴板加载笔划墨迹
• 墨迹工具栏位置和方向示例（基本）
• 墨迹工具栏位置和方向示例（动态）
• Coloring Book 示例
• 系列说明示例
• JavaScript) (墨迹书写示例
• 简单墨迹书写示例 (C#/C++)
• 复杂墨迹书写示例 (C++)
• 墨迹分析示例