IInkCollector：:p ut_Enabled 方法 (msinkaut.h)

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

此属性是可读写的。

语法

HRESULT put_Enabled(
  VARIANT_BOOL Collecting
);

参数

Collecting

返回值

无

备注

如果启用对象的窗口输入矩形 (在构造函数中设置，或使用 启用对象的 SetWindowInputRectangle 方法) 与另一个已启用对象的窗口输入矩形重叠，则返回E_INK_OVERLAPPING_INPUT_RECT错误。 只要在任何已知时间只启用其中一个输入矩形，重叠就不会出现错误。

未启用对象时，不会收到任何事件。

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

当对象收集墨迹时，不能将 Enabled 属性设置为 FALSE ， (CollectingInk 属性为 TRUE) 。

建议在应用程序关闭时将 “已启用 ”设置为 FALSE 。

注意 在某些消息处理程序中设置此属性可能会导致重新输入基础函数，从而导致意外的结果。 处理以下任何消息时，请小心避免重入调用：WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINT;如果wParam 设置为 SC_HOTKEY 或 SC_TASKLIST，则WM_SYSCOMMAND;处理 Alt-Tab 或 Alt-Esc 组合键) 时WM_SYSKEYDOWN (。 这是单线程单元模型应用程序的问题。

 

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

属性

• AttachMode
• hWnd
• 墨迹
• MarginX
• MarginY

方法

• SetAllTabletsMode
• SetSingleTabletIntegratedMode

要求

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

另请参阅

AttachMode 属性

CollectingInk 属性

CollectionMode 属性 [InkCollector 类]

EditingMode 属性 [InkOverlay 类]

IInkCollector

Ink 属性 [InkCollector/InkOverLay 类]

InkCollector 类

MarginX 属性

MarginY 属性

SetAllTabletsMode 方法

SetSingleTabletIntegratedMode 方法

SetWindowInputRectangle 方法

hWnd 属性