ITipAutocompleteClient::RequestShowUI 方法

确定输入面板是否已准备好显示自动完成列表。

语法

HRESULT RequestShowUI(
  [in]  HWND hWndACList,
  [out] BOOL *pfAllowShowing
);

参数

hWndACList [in]

自动完成列表用户界面的窗口句柄。

pfAllowShowing [out]

如果客户端建议不显示自动完成列表用户界面,则为 FALSE。 如果自动完成提供程序可以显示列表用户界面,则为 TRUE

返回值

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

返回代码 说明
S_OK
成功。
E_FAIL
发生了未指定的错误。

备注

此方法由自动完成提供程序在即将显示自动完成用户界面时调用。 如果客户端的内部状态不允许提供程序显示用户界面, 则 pfAllowShowing 将设置为 FALSE。 例如,当文本从平板电脑电脑输入面板上的手写外观发送到字段,并且用户立即开始墨迹书写时,客户端将建议不要显示自动完成的用户界面,以避免破坏用户的墨迹,方法是将 pfAllowShowing 设置为 FALSE

调用 RequestShowUI 以在调用 ITipAutocompleteClient::P referredRects 方法之前设置弹出窗口自动完成列表窗口句柄。 否则,调用 PreferredRects 时将导致E_INVALIDARG错误。

要求

要求
最低受支持的客户端
Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器
无受支持的版本
标头
TipAutoComplete.h (还需要 Peninputpanel_i.c)
DLL
Tiptsf.dll

另请参阅

ITipAutocompleteClient 接口

ITipAutocompleteClient::P referredRects 方法

文本输入面板参考