InkOverlay.Enabled 属性

获取或设置一个值,该值指定 InkOverlay 对象是否收集笔输入。

命名空间:  Microsoft.Ink
程序集:  Microsoft.Ink(在 Microsoft.Ink.dll 中)

语法

声明
<BrowsableAttribute(False)> _
Public Property Enabled As Boolean
用法
Dim instance As InkOverlay
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value
[BrowsableAttribute(false)]
public bool Enabled { get; set; }
[BrowsableAttribute(false)]
public:
property bool Enabled {
    bool get ();
    void set (bool value);
}
/** @property */
/** @attribute BrowsableAttribute(false) */
public boolean get_Enabled()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_Enabled(boolean value)
public function get Enabled () : boolean
public function set Enabled (value : boolean)

属性值

类型:System.Boolean
InkOverlay 对象是否收集笔输入。
如果 InkOverlay 对象收集笔输入,则为 true。
如果 InkOverlay 对象不报告笔输入,则为 false。不激发与笔相关的事件。

备注

除了墨迹以外,笔输入可包括 in-air packet、光标在范围中事件,等等。

在 Microsoft Windows Vista、Windows XP Tablet PC Edition 或安装了 Windows XP Tablet PC Edition SDK 的任何版本的 Windows 2000、Windows Server 2003 或 Windows XP 中,InkOverlay 对象都收集墨迹。但是,从 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。

如果启用的 InkCollectorInkOverlay(在构造函数中设置或使用 SetWindowInputRectangle 方法设置)的窗口输入矩形与 InkOverlay 的窗口输入矩形重叠,则会引发 COMException 异常。

备注

任何时候只要仅启用一个输入矩形,那么即使发生重叠也不会出错。

如果未启用控件,则不会接收到任何事件。

如果将容器控件的 Enabled 属性设置为 false,则还会禁用它包含的所有控件。

如果对象在收集墨迹CollectingInk 属性为 true),则不能将 Enabled 属性设置为 false。

在设置或调用对象的特定属性和方法之前,Enabled 属性必须设置为 false。如果试图更改这些属性或调用这些方法,则会发生错误。

除非先将 Enabled 属性设置为 false,否则不能设置或调用以下属性和方法:

关闭应用程序之前,应将 InkOverlay 对象的 Enabled 属性设置为 false。

示例

此 C# 示例创建并启用 InkOverlay 对象。

using Microsoft.Ink;
//...
InkOverlay theInkOverlay = new InkOverlay(Handle);
theInkOverlay.Enabled = true;
//...

此 Microsoft Visual Basic .NET 示例创建并启用 InkOverlay 对象。

Imports Microsoft.Ink
'...
Dim theInkOverlay As New InkOverlay(Handle)
theInkOverlay.Enabled() = True
'...

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

版本信息

.NET Framework

受以下版本支持:3.0

另请参见

参考

InkOverlay 类

InkOverlay 成员

Microsoft.Ink 命名空间

InkOverlay.Handle

InkOverlay.Ink

InkOverlay.MarginX

InkOverlay.MarginY

InkOverlay.SetAllTabletsMode

InkOverlay.SetSingleTabletIntegratedMode

InkOverlay.CollectingInk