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