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。
如果启用的 InkCollector 或 InkOverlay(在构造函数中设置或使用 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