IInkPicture::p ut_InkEnabled メソッド (msinkaut.h)

[アーティクル]
08/25/2023

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

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

構文

HRESULT put_InkEnabled(
  VARIANT_BOOL Collecting
);

パラメーター

Collecting

戻り値

なし

解説

InkPicture コントロールは、Windows Vista、Microsoft Windows XP タブレット PC エディション、または Windows XP タブレット PC Edition ソフトウェア開発キット (SDK) がインストールされている Windows 2000、Windows Server 2003、または Windows XP の任意のエディションのインクを収集します。ただし、手書き認識は、Windows Vista、Windows XP Tablet PC Edition、または Recognizer Pack がインストールされている場合にのみ発生します。

Windows 2000、Windows Server 2003、または Windows XP タブレット PC エディション以外の Windows XP のどのエディションでも、Tablet PC SDK がインストールされていない場合、 InkEnabled プロパティは常に FALSE になります。

有効なオブジェクトのウィンドウ入力四角形 (コンストラクターまたは SetWindowInputRectangle メソッドで設定) が別の有効なオブジェクトのウィンドウ入力四角形と重なっている場合は、E_INK_OVERLAPPING_INPUT_RECTエラーが返されます。

メモ入力四角形の 1 つだけがいつでも有効になっている限り、重複はエラーなしで発生する可能性があります。

InkPicture コントロールが有効になっていない間、イベントは表示されません。

コンテナー InkPicture コントロールの Enabled プロパティをVARIANT_FALSEに設定すると、含まれるすべてのコントロールも無効になります。

InkPicture コントロールがインクを収集しているときに、このプロパティを VARIANT_FALSE に設定することはできません (CollectingInk プロパティプロパティがVARIANT_TRUE)。

最良の結果を得るには、 Enabled プロパティをアプリケーションのシャットダウン時に VARIANT_FALSE に設定します。

コントロールの特定のプロパティとメソッドを設定または呼び出す前に、このプロパティを VARIANT_FALSE に設定する必要があります。指定したプロパティを変更しようとした場合、または指定したメソッドを呼び出そうとすると、エラーが発生します。 Enabled プロパティが最初に VARIANT_FALSE に設定されていない限り、次のプロパティとメソッドを設定または呼び出すことはできません。

プロパティ:
メソッド:
- SetAllTabletsMode メソッド
- SetSingleTabletIntegratedMode メソッド

要件

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