インクを描画するウィンドウの四角形をピクセル単位で設定します。
構文
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 キーの組み合わせを処理する場合)。 これは、シングルスレッドアパートメントモデルアプリケーションの問題です。
必要条件
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| ターゲット プラットフォーム の | Windows |
| ヘッダー | msinkaut.h |