ITipAutocompleteClient::RequestShowUI 方法
确定输入面板是否已准备好显示自动完成列表。
语法
HRESULT RequestShowUI(
[in] HWND hWndACList,
[out] BOOL *pfAllowShowing
);
参数
-
hWndACList [in]
-
自动完成列表用户界面的窗口句柄。
-
pfAllowShowing [out]
-
如果客户端建议不显示自动完成列表用户界面,则为 FALSE。 如果自动完成提供程序可以显示列表用户界面,则为 TRUE。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
成功。 |
|
发生了未指定的错误。 |
备注
此方法由自动完成提供程序在即将显示自动完成用户界面时调用。 如果客户端的内部状态不允许提供程序显示用户界面, 则 pfAllowShowing 将设置为 FALSE。 例如,当文本从平板电脑电脑输入面板上的手写外观发送到字段,并且用户立即开始墨迹书写时,客户端将建议不要显示自动完成的用户界面,以避免破坏用户的墨迹,方法是将 pfAllowShowing 设置为 FALSE。
调用 RequestShowUI 以在调用 ITipAutocompleteClient::P referredRects 方法之前设置弹出窗口自动完成列表窗口句柄。 否则,调用 PreferredRects 时将导致E_INVALIDARG错误。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP Tablet PC Edition [仅限桌面应用] |
最低受支持的服务器 |
无受支持的版本 |
标头 |
|
DLL |
|