InkManager 类

定义

命名空间:

Windows.UI.Input.Inking

注意

对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，我们建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。

管理输入、操作和处理 (包括一个或多个 InkStroke 对象的手写识别) 。

public ref class InkManager sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class InkManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class InkManager

function InkManager()

Public NotInheritable Class InkManager

继承

Object Platform::Object IInspectable InkManager

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IInkRecognizerContainer IInkStrokeContainer

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 中引入)

示例

此示例演示如何创建 InkManager 对象。

var inkManager = new Windows.UI.Input.Inking.InkManager();

以下函数演示如何选择 画布 上属于此 InkManager (inkManager) 的笔划集合中的所有墨迹笔划。

function selectAll()
{
    inkManager.getStrokes().forEach(
        function (stroke) 
        {
            stroke.selected = 1;
        }
    );
}

注解

如果不需要识别，请使用 InkStrokeContainer 对象而不是 InkManager。 以前的识别结果仍可通过 GetRecognitionResults 获得。

如果只需要识别，而不需要存储，请使用 InkRecognizerContainer 而不是 InkManager。

注意

此类不是敏捷类，这意味着需要考虑其线程模型和封送处理行为。 有关详细信息，请参阅线程处理和封送处理 (C++/CX) 和在多线程环境中使用 Windows 运行时 对象 (.NET) 。

构造函数

InkManager()

注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 创建用于管理 InkStroke 对象的新 InkManager 对象。

属性

BoundingRect	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 获取由 InkManager 管理的 InkStroke 集合的边框。
Mode	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 获取或设置墨迹输入模式。

方法

AddStroke(InkStroke)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 将一个或多个 InkStroke 对象添加到由 InkManager 管理的集合中。
CanPasteFromClipboard()	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 标识是否可以将剪贴板上的内容添加到 InkManager 管理的 InkStroke 集合。 注意 剪贴板内容必须采用墨迹序列化格式 (ISF) 。
CopySelectedToClipboard()	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 将 InkManager) 管理的 InkStroke 集合中选定的 InkStroke 对象 (复制到墨迹序列化格式 (ISF) 格式的剪贴板。
DeleteSelected()	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 从 InkManager 管理的 InkStroke 集合中删除选定的 InkStroke 对象。
GetRecognitionResults()	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 检索手写识别返回的单词的集合。
GetRecognizers()	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 获取已安装的手写识别器的集合。
GetStrokes()	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 检索 由 InkManager 管理的集合中的所有墨迹笔划。
LoadAsync(IInputStream)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 将所有 InkStroke 对象从指定流异步加载到 InkManager 管理的 InkStroke 集合。 墨迹数据 (ISF) 元数据序列化为墨迹序列化格式，并嵌入到图形交换格式 (GIF) 文件中。
MoveSelected(Point)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 移动所选笔划。 将重新呈现所有受影响的笔划。
PasteFromClipboard(Point)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 将剪贴板中的 InkStroke 内容添加到 InkManager 管理的 InkStroke 集合并呈现新笔划。
ProcessPointerDown(PointerPoint)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 处理有关初始向下接触点的位置和特征的信息，例如压力和倾斜。 在调用 ProcessPointerUpdate 和 ProcessPointerUp 之前，必须调用此方法。 重要 桌面应用不支持此方法。
ProcessPointerUp(PointerPoint)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 处理有关接触点的位置和特征的信息，如向上接触点的压力和倾斜。 必须在调用 ProcessPointerUpdate 后调用此方法。 重要 桌面应用不支持此方法。
ProcessPointerUpdate(PointerPoint)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 处理从最后一个指针事件到当前指针事件（包括当前指针事件）的位置和状态属性，如压力和倾斜。在 ProcessPointerDown 之后和 ProcessPointerUp 之前调用此方法。 重要 桌面应用不支持此方法。
RecognizeAsync(InkRecognitionTarget)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 对一个或多个 InkStroke 对象执行手写识别。
RecognizeAsync(InkStrokeContainer, InkRecognitionTarget)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 对一个或多个 InkStroke 对象执行手写识别。
SaveAsync(IOutputStream)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 异步将 InkManager 管理的 InkStroke 集合中的所有 InkStroke 对象保存到指定的流中。 墨迹数据 (ISF) 元数据序列化为墨迹序列化格式，并嵌入到图形交换格式 (GIF) 文件中。
SelectWithLine(Point, Point)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 选择与新笔划相交的所有笔划。 注意 为集合中的所有其他笔划重置 Selected 标志。
SelectWithPolyLine(IIterable<Point>)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 选择完全包含在折线中的所有笔划。 注意 为集合中的所有其他笔划重置 Selected 标志。 .
SetDefaultDrawingAttributes(InkDrawingAttributes)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 为添加到 InkManager 管理的 InkStroke 集合的所有新 InkStroke 对象设置默认 InkDrawingAttributes。 SetDefaultDrawingAttributes 不会影响当前笔划或任何现有笔划。
SetDefaultRecognizer(InkRecognizer)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 设置用于手写识别的默认 InkRecognizer 。
UpdateRecognitionResults(IVectorView<InkRecognitionResult>)	注意 对于使用可扩展应用程序标记语言 (XAML) 的通用 Windows 应用，建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。 汇报手写识别中潜在文本匹配项的集合。

另请参阅

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