ITipAutocompleteClient：:P referredRects 方法

可讓用戶端建議自動完成清單的位置，以避免重迭輸入面板。

語法

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

中國ACList [in]: 矩形，以螢幕座標表示提供者的慣用位置和自動完成清單使用者介面的大小。
prcField [in]: 矩形，以螢幕座標表示焦點欄位的位置和大小。
prcModified [out]: 矩形，以 TIP 的目前狀態和 中國ACList所指定的慣用自動完成清單位置和大小為基礎。
pfShownAboveTip [in， out]: 如果修改過的矩形顯示在文字輸入面板的目的地區域上方，則為TRUE;否則為FALSE。呼叫方法之前，這個值必須初始化為提供者的慣用方向。

這個方法可以傳回下列其中一個值。

傳回碼	描述
S_OK	成功。
E_INVALIDARG	呼叫 ITipAutocompleteClient：：RequestShowUI 方法以設定快顯自動完成清單視窗，再呼叫 ITipAutocompleteClient：:P referredRects 方法。
E_FAIL	發生未指定的錯誤。

這是自動完成提供者即將顯示自動完成使用者介面時所呼叫的方法。用戶端會透過中國Modified引數修改中國ACList所指定的提供者慣用矩形。

呼叫 ITipAutocompleteClient：：RequestShowUI 方法 ，以在您呼叫 PreferredRects之前設定快顯自動完成清單視窗控制碼。呼叫PreferredRects時，若無法這麼做，將會導致E_INVALIDARG錯誤。

需求	值
最低支援的用戶端	Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器	都不支援
標頭	TipAutoComplete.h (也需要 Peninputpanel_i.c)
DLL	Tiptsf.dll