IInkCollector::SetWindowInputRectangle メソッド (msinkaut.h)

インクを描画するウィンドウの四角形をピクセル単位で設定します。

構文

HRESULT SetWindowInputRectangle(
  [in] IInkRectangle *WindowInputRectangle
);

パラメーター

[in] WindowInputRectangle

インクが描画される四角形 (ウィンドウ座標)。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
正常終了しました。
E_POINTER
パラメーターに無効なポインターが含まれていました。
E_INVALIDARG
四角形の座標が無効です (幅/高さが 0 など)。
E_INK_COLLECTOR_BUSY
ストロークの途中でマッピングを更新できません。
E_INK_EXCEPTION
メソッド内で例外が発生しました。
E_INK_OVERLAPPING_INPUT_RECT
ウィンドウ入力四角形は、有効な InkCollector のウィンドウ入力四角形と重なります。

解説

有効なインク コレクターのウィンドウ入力四角形 ( Enabled プロパティで設定) が別の有効なインク コレクターのウィンドウ入力四角形と重なっている場合、E_INK_OVERLAPPING_INPUT_RECT エラーが返されます。

メモ 入力四角形の 1 つだけが既知の時点で有効になっている限り、重複はエラーなしで発生する可能性があります。
 
既定では、ウィンドウ入力の四角形は に {0,0,0,0}設定されます。 この既定の四角形は、ウィンドウ全体のサイズにマップされます。

ウィンドウ入力の四角形を既定の動作 (座標{0,0,0,0}を持つ空の四角形) にリセットするには、NULL ではなく SetWindowInputRectangle への呼び出しを渡{0,0,0,0}します。

Right プロパティの値が Left プロパティの値より小さい四角形を渡すことはできません。または、Bottom プロパティの値が Top プロパティの値より小さい場合は 。 たとえば、パラメーター {500、500、400、400} の四角形は無効です。

注意 ウィンドウ入力の四角形を分割コントロールまたはウィンドウの境界線と重なるように設定すると、ウィンドウのサイズが変更されたときに予期しない結果が発生する可能性があります。
 
メモ 特定のメッセージ ハンドラー内でこのメソッドを呼び出すと、基になる関数が再入力され、予期しない結果が発生する可能性があります。 WM_ACTIVATE、WM_ACTIVATEAPPWM_NCACTIVATE、WM_PAINTのいずれかのメッセージを処理するときは、再入可能な呼び出しを避けてください。 wParamSC_HOTKEY または SC_TASKLIST に設定されているかどうかをWM_SYSCOMMANDします。と WM_SYSKEYDOWN (Alt + TAB キーまたは Alt + ESC キーの組み合わせを処理する場合)。 これは、シングルスレッドアパートメントモデルアプリケーションの問題です。
 

要件

   
サポートされている最小のクライアント Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー msinkaut.h
Library InkObj.dll

関連項目

Enabled プロパティ

GetWindowInputRectangle メソッド

IInkCollector

InkCollector クラス