IInkOverlay::get_Enabled メソッド (msinkaut.h)
InkOverlay オブジェクトがペン入力 (空中パケット、範囲内のカーソル イベントなど) を収集するかどうかを指定する値を取得または設定します。
このプロパティは読み取り/書き込み可能です。
構文
HRESULT get_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 Tablet PC Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |
関連項目
CollectionMode プロパティ [InkCollector クラス]
EditingMode プロパティ [InkOverlay クラス]