IInkOverlay::p ut_Enabled メソッド (msinkaut.h)
InkOverlay オブジェクトがペン入力 (空中パケット、範囲イベント内のカーソルなど) を収集するかどうかを指定する値を取得または設定します。
このプロパティは読み取り/書き込み可能です。
構文
HRESULT put_Enabled(
VARIANT_BOOL Collecting
);
パラメーター
Collecting
戻り値
なし
解説
有効なオブジェクトの有効なオブジェクトのウィンドウ入力四角形 (コンストラクターまたは SetWindowInputRectangle メソッドで設定) が、有効になっている別のオブジェクトのウィンドウ入力四角形と重なっている場合は、E_INK_OVERLAPPING_INPUT_RECT エラーが返されます。 入力四角形の 1 つだけが既知の時点で有効になっている限り、重複はエラーなしで発生する可能性があります。
オブジェクトが有効になっていない間は、イベントを受け取りません。
コンテナー コントロールの Enabled プロパティが FALSE に設定されている場合、含まれるすべてのコントロールも無効になります。
オブジェクトがインクを収集しているときに Enabled プロパティを FALSE に設定することはできません (CollectingInk プロパティは TRUE)。
アプリケーションのシャットダウン時に Enabled を FALSE に設定することをお勧めします。
メモ 特定のメッセージ ハンドラー内でこのプロパティを設定すると、基になる関数が再入力され、予期しない結果が発生する可能性があります。 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 |
関連項目
CollectionMode プロパティ [InkCollector クラス]
EditingMode プロパティ [InkOverlay クラス]