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

  • [アーティクル]

InkCollector オブジェクトがペン入力を収集するかどうかを指定する値を取得または設定します (空中パケット、範囲イベント内のカーソルなど)。

このプロパティは読み取り/書き込み可能です。

構文

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 する場合)。 これは、シングルスレッド アパートメント モデル アプリケーションの問題です。
 
オブジェクトの特定のプロパティとメソッドを設定または呼び出す前に、このプロパティを FALSE に設定する必要があります。 指定したプロパティまたはメソッドを変更しようとすると、エラーが発生します。 Enabled プロパティが最初に FALSE に設定されていない限り、次のプロパティとメソッドを設定または呼び出すことはできません。

プロパティ

メソッド

要件

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

関連項目

AttachMode プロパティ

CollectingInk プロパティ

CollectionMode プロパティ [InkCollector クラス]

EditingMode プロパティ [InkOverlay クラス]

IInkCollector

Ink プロパティ [InkCollector/InkOverLay クラス]

InkCollector クラス

MarginX プロパティ

MarginY プロパティ

SetAllTabletsMode メソッド

SetSingleTabletIntegratedMode メソッド

SetWindowInputRectangle メソッド

hWnd プロパティ