ITipAutocompleteClient：:P referredRects 方法

  • 项目

允许客户端建议自动完成列表的位置，以避免与输入面板重叠。

语法

HRESULT PreferredRects(
  [in]      RECT *prcACList,
  [in]      RECT *prcField,
  [out]     RECT *prcModified,
  [in, out] BOOL *pfShownAboveTip
);

参数

prcACList [in]

一个矩形，以屏幕坐标表示提供程序的首选位置和自动完成列表用户界面的大小。

prcField [in]

一个矩形，以屏幕坐标表示焦点字段的位置和大小。

prcModified [out]

基于 TIP 的当前状态以及 由 prcACList 指定的首选自动完成列表位置和大小的矩形。

pfShownAboveTip [in， out]

如果修改后的矩形显示在文本输入面板的目标区域上方，则为 TRUE;否则为 FALSE。 在调用 方法之前，必须将此值初始化为提供程序的首选方向。

返回值

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

返回代码 说明
S_OK
 成功。
E_INVALIDARG
 调用 ITipAutocompleteClient：：RequestShowUI 方法 以设置弹出式自动完成列表窗口，然后再调用 ITipAutocompleteClient：:P referredRects 方法。
E_FAIL
 发生了未指定的错误。

备注

这是自动完成提供程序在即将显示自动完成用户界面时调用的方法。 客户端通过 prcModified 参数修改由 prcACList 指定的提供程序的首选矩形。

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

要求

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

另请参阅

ITipAutocompleteClient 接口

ITipAutocompleteClient：：RequestShowUI 方法

文本输入面板参考