IInkCollector::SetWindowInputRectangle メソッド (msinkaut.h)
インクを描画するウィンドウの四角形をピクセル単位で設定します。
構文
HRESULT SetWindowInputRectangle(
[in] IInkRectangle *WindowInputRectangle
);
パラメーター
[in] WindowInputRectangle
インクが描画される四角形 (ウィンドウ座標)。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
四角形の座標が無効です (幅/高さが 0 など)。 |
|
ストロークの途中でマッピングを更新できません。 |
|
メソッド内で例外が発生しました。 |
|
ウィンドウ入力四角形は、有効な InkCollector のウィンドウ入力四角形と重なります。 |
解説
有効なインク コレクターのウィンドウ入力四角形 ( Enabled プロパティで設定) が別の有効なインク コレクターのウィンドウ入力四角形と重なっている場合、E_INK_OVERLAPPING_INPUT_RECT エラーが返されます。
メモ 入力四角形の 1 つだけが既知の時点で有効になっている限り、重複はエラーなしで発生する可能性があります。
ウィンドウ入力の四角形を既定の動作 (座標{0,0,0,0}を持つ空の四角形) にリセットするには、NULL ではなく SetWindowInputRectangle への呼び出しを渡{0,0,0,0}します。
Right プロパティの値が Left プロパティの値より小さい四角形を渡すことはできません。または、Bottom プロパティの値が Top プロパティの値より小さい場合は 。 たとえば、パラメーター {500、500、400、400} の四角形は無効です。
注意 ウィンドウ入力の四角形を分割コントロールまたはウィンドウの境界線と重なるように設定すると、ウィンドウのサイズが変更されたときに予期しない結果が発生する可能性があります。
メモ 特定のメッセージ ハンドラー内でこのメソッドを呼び出すと、基になる関数が再入力され、予期しない結果が発生する可能性があります。 WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINTのいずれかのメッセージを処理するときは、再入可能な呼び出しを避けてください。 wParam が SC_HOTKEY または SC_TASKLIST に設定されているかどうかをWM_SYSCOMMANDします。と WM_SYSKEYDOWN (Alt + TAB キーまたは Alt + ESC キーの組み合わせを処理する場合)。 これは、シングルスレッドアパートメントモデルアプリケーションの問題です。
要件
| サポートされている最小のクライアント | Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |