InkCollector.Enabled 属性
获取或设置一个值，该值指定 InkCollector 对象是否收集笔输入。
命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）
语法
声明
Public Property Enabled As Boolean
用法
Dim instance As InkCollector
Dim value As Boolean
value = instance.Enabled
instance.Enabled = value
public bool Enabled { get; set; }
public:
property bool Enabled {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_Enabled()
/** @property */
public void set_Enabled(boolean value)
public function get Enabled () : boolean
public function set Enabled (value : boolean)
属性值
类型：System.Boolean
如果 InkCollector 对象收集笔输入，则为 true。如果 InkCollector 对象不报告笔输入，则为 false。不激发与笔相关的事件。
备注
除了墨迹以外，笔输入可包括 in-air packet、光标在范围中事件，等等。
在 Microsoft(R) Windows(R) XP Tablet PC Edition 或安装了 Windows XP Tablet PC Edition SDK 的 Windows 2000、Windows Server 2003 或 Windows XP 的任何版本中，InkCollector 对象都收集墨迹。但是，仅当使用 Windows XP Tablet PC Edition 时，才会进行手写 识别。除 Windows XP Tablet PC Edition 外，Windows 2000、Windows Server 2003 或 Windows XP 的任何版本中，如果不安装 Windows XP Tablet PC Edition SDK，则 Enabled 属性始终是 false。
如果启用的 InkCollector 或 InkOverlay（在构造函数中设置或使用 SetWindowInputRectangle 方法设置）的窗口输入矩形与 InkCollector 的窗口输入矩形重叠，则会引发 COMException 异常。
备注
任何时候只要仅启用一个输入矩形，那么即使发生重叠也不会出错。
如果未启用控件，则不会接收到任何事件。
如果将容器控件的 Enabled 属性设置为 false，则还会禁用它包含的所有控件。
如果对象在收集墨迹（CollectingInk 属性为 true），则不能将 Enabled 属性设置为 false。
在设置或调用对象的特定属性和方法之前，Enabled 属性必须设置为 false。如果试图更改这些属性或调用这些方法，则会发生错误。
除非先将 Enabled 属性设置为 false，否则不能设置或调用以下属性和方法：
关闭应用程序之前，应将 InkCollector 对象的 Enabled 属性设置为 false。
备注
如果在某些消息处理程序内设置 Enabled 属性，则可以重新进入此函数，从而导致意外的结果。在处理以下任一消息时，请注意避免可重入调用：WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINT；WM_SYSCOMMAND（如果 wParam 设置为 SC_HOTKEY 或 SC_TASKLIST）；以及 WM_SYSKEYDOWN（处理 Alt-Tab 或 Alt-Esc 组合键时）。这是单线程单元模型应用程序的问题。
示例
此 C# 示例创建并启用 InkCollector 对象。
using Microsoft.Ink;
//...
InkCollector theInkCollector = new InkCollector(Handle);
theInkCollector.Enabled = true;
//...
此 Microsoft Visual Basic .NET 示例创建并启用 InkCollector 对象。
Imports Microsoft.Ink
'...
Dim theInkCollector As New InkCollector(Handle)
theInkCollector.Enabled() = True
'...
平台
Windows Vista
.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。
版本信息
.NET Framework
受以下版本支持：3.0
另请参见
参考
InkCollector.SetAllTabletsMode