iInkPicture：：get_InkEnabled 方法 (msinkaut.h)

获取或设置一个值，该值指定 InkPicture 控件是否收集笔输入 (空中数据包、范围事件中的光标等) 。

此属性是可读写的。

语法

HRESULT get_InkEnabled(
  VARIANT_BOOL *Collecting
);

参数

Collecting

返回值

无

备注

InkPicture 控件收集安装了 Windows XP 平板电脑版软件开发工具包 (SDK) 的 Windows Vista、Microsoft Windows XP 平板电脑版或任何版本的 Windows 2000、Windows Server 2003 或 Windows XP 中的墨迹。 但是，仅当安装了 Windows Vista、Windows XP Tablet PC Edition 或 Recognizer Pack 时，才会进行手写识别。

在任何版本的 Windows 2000、Windows Server 2003 或 Windows XP 平板电脑版以外的 Windows XP 中，如果未安装平板电脑 SDK，InkEnabled 属性始终为 FALSE 。

如果已启用对象的窗口输入矩形 (构造函数中设置，或者与 SetWindowInputRectangle 方法) 与另一个已启用对象的窗口输入矩形重叠，则返回E_INK_OVERLAPPING_INPUT_RECT错误。

注意 只要在任何时候只启用其中一个输入矩形，重叠就不会出现错误。

 

未启用 InkPicture 控件时，不会收到任何事件。

当容器 InkPicture 控件的 Enabled 属性设置为VARIANT_FALSE时，其包含的所有控件也会被禁用。

当 InkPicture 控件正在收集墨迹时，不能将此属性设置为 VARIANT_FALSE (VARIANT_TRUE ) 。

为获得最佳结果，请将 Enabled 属性设置为在应用程序关闭时 VARIANT_FALSE 。

在设置或调用控件的特定属性和方法之前，此属性必须设置为 VARIANT_FALSE 。 如果尝试更改指定的属性或调用指定的方法，则会发生错误。 除非首先将 Enabled 属性设置为 VARIANT_FALSE，否则无法设置或调用以下属性和方法：

1. 属性:
   • 墨迹
   • MarginX 属性
   • MarginY 属性
2. 方法：
   • SetAllTabletsMode 方法
   • SetSingleTabletIntegratedMode 方法

要求

要求	值
最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	msinkaut.h
Library	InkObj.dll

另请参阅

CollectionMode 属性 [InkPicture 控件]

EditingMode 属性 [InkPicture 控件]

Enabled 属性 [InkPicture 控件]

IInkPicture

Ink 属性 [InkPicture 控件]

InkPicture 控件

MarginX 属性

MarginY 属性

SetAllTabletsMode 方法

SetSingleTabletIntegratedMode 方法

SetWindowInputRectangle 方法