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。 メソッドを呼び出す前に、この値をプロバイダーの優先方向に初期化する必要があります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
成功しました。 |
|
ITipAutocompleteClient::RequestShowUI メソッドを呼び出して、ITipAutocompleteClient::P referredRects メソッドを呼び出す前に、ポップアップのオートコンプリート リスト ウィンドウを設定します。 |
|
未指定のエラーが発生しました。 |
解説
これは、オートコンプリート のユーザー インターフェイスを表示しようとしているときに、オートコンプリート プロバイダーが呼び出すメソッドです。 クライアントは、prcModified 引数を使用して prcACList で指定されたプロバイダーの優先四角形を変更します。
PreferredRects を呼び出す前に、ITipAutocompleteClient::RequestShowUI メソッドを呼び出して、ポップアップのオートコンプリート リスト ウィンドウ ハンドルを設定します。 これを行わないと、PreferredRects を呼び出すときにE_INVALIDARG エラーが発生します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP Tablet PC Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| ヘッダー |
|
| [DLL] |
|