IPenInputPanel：：EnableTsf 方法 (peninputpanel.h)

  • 项目

[ PenInputPanel 已替换为 文本输入面板 (TIP) 。]

已弃用。 获取或设置一个布尔值，该值指示 PenInputPanel 对象是否尝试通过 文本服务框架 (TSF) 将文本发送到附加控件，并启用 更正 用户界面。

语法

HRESULT EnableTsf(
  VARIANT_BOOL Enable
);

parameters

Enable

如果 PenInputPanel 对象应尝试使用 TSF 将文本发送到附加的控件，并且应启用更正用户界面，则为 TRUE;否则为 FALSE。 默认值为 TRUE。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
 成功。
E_UNEXPECTED
 意外的参数或属性类型。
E_NOINTERFACE
 TSF 接口不会在附加的控件上公开。
E_FAIL
 发生了未指定的错误。

注解

在 Enable 设置为 TRUE 的情况下调用此方法会导致 PenInputPanel 对象尝试在附加的控件上启动 TSF。

应使用 EnableTsf 使 PenInputPanel 能够使用 TSF 插入上下文而不是 SendInput 函数将手写识别结果发送到控件中。 结果是即使字段不再具有焦点，也可以插入文本。

调用值为 TRUE 的 EnableTsf 时，PenInputPanel 对象会将EM_SETEDITSTYLE消息发送到附加的控件。 如果控件不支持此消息，则结果可能是不可预知的。 InkEdit 控件支持 TSF。

对旧版应用程序的支持

已向 TSF 和 Microsoft Windows 添加支持，以便为桌面上的所有应用程序提供一致的用户界面。 这种新的支持使不了解 TSF 的旧应用程序或控件能够免费利用某些高级文本服务。 例如，语音听写和手写现在可以用于在任何应用程序中将文本输入到文档中。

此新功能在 Windows XP Tablet PC Edition 上默认可用并启用。 若要启用或禁用它，请：

  1. 在“控制面板”中，单击“区域和语言选项”。
  2. 在“ 语言 ”选项卡上，单击“ 详细信息”。
  3. 在“文本服务和输入语言”对话框的“高级”选项卡上，选择或清除“将高级文本服务支持扩展到所有程序”。
如果成功，文本将通过 TSF 发送到附加的控件。 此外，如果控件支持 TSF (，并且不只是因为已为 控制面板 中的所有程序启用了高级文本服务而从 TSF 接收文本，如上) 所述，则更正用户界面将显示在 控件中，并允许访问手写替代项。 在 Enable 设置为 FALSE 的情况下调用此方法会导致 PenInputPanel 对象尝试关闭附加控件上的 TSF。

要求

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

请参阅

IPenInputPanel

PenInputPanel