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

  • [アーティクル]

インク、ジェスチャ、またはその両方がユーザーの書き込み時に認識されるかどうかを決定するコレクション モードを取得または設定します。

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

構文

HRESULT get_CollectionMode(
  InkCollectionMode *Mode
);

パラメーター

Mode

戻り値

なし

解説

使用できるモードの一覧については、 InkCollectionMode 列挙型を参照してください。 ただし、Microsoft Windows XP Tablet PC Edition Software Development Kit (SDK) がインストールされているが認識エンジンがインストールされていないシステムで CollectionMode プロパティを使用する場合、モードを GestureOnly または InkAndGesture に設定することはできません。

メモInkCollector オブジェクト、InkOverlay オブジェクト、または InkPicture コントロールは、インクの収集中に CollectionMode プロパティを変更しようとするとエラーを生成します。 この競合を回避するには、CollectionMode プロパティを変更する前に CollectingInk プロパティをチェックします。
 
CollectionMode 値ごとに次の動作が発生します。

InkOnly モード

  • インクのみが収集されます。ジェスチャは行われません。
  • Gesture イベントのインタレストは FALSE に設定されます (他のすべてのイベントの関心は、そのまま残ります)。

GestureOnly モード

  • ジェスチャのみが収集されます。インクがありません。 ストロークは、ジェスチャ認識エンジンに送信された後に削除されます。
  • Gesture イベントのインタレストは TRUE に設定されます (他のすべてのイベントの関心は、そのまま残ります)。
  • インク コレクターは、 CursorDown、 Stroke、 NewPackets、 および NewInAirPackets イベントのストロークおよびパケット関連のイベントを発生させません。
  • カーソル イベントが発生します。
  • インクは常に削除されます。

InkAndGesture モード

  • インクとジェスチャの両方が収集されます。
  • 1 回のストローク ジェスチャのみが認識されます。
  • Gesture イベントのインタレストは TRUE に設定されます (他のすべてのイベントの関心は、そのまま残ります)。
  • Gesture イベントが最初に発生し、ジェスチャを受け入れるか取り消せるようにします。 ジェスチャを取り消すには、 Cancel パラメーターを TRUE に設定します。 ジェスチャをキャンセルすると、インク コレクターは強制的にインクを収集します。
コレクション モードを変更しても、個々のジェスチャの状態は変更されません。

CollectionMode が InkAndGesture に設定されていて、オブジェクト/コントロールの既知のジェスチャに対する関心が (SetGestureStatus メソッドを呼び出すことによって) 設定されている場合、望ましくない動作が発生する可能性があります。 既知のジェスチャのように見えるインクを描画し、既知のジェスチャが認識エンジンの代替の一覧にある場合、 ジェスチャ イベントが発生し、ジェスチャが最上位の代替手段ではない場合でもインクが消えます。 インクが消えなくなり、ジェスチャのコレクションが取り消されないようにするには、イベントが関心のないイベントである場合は 、Cancel パラメーターを TRUE に設定します。

CollectionMode が GestureOnly に設定されている場合、ユーザーがジェスチャを追加してから Gesture イベントが発生したときのタイムアウトは、プログラムで変更できない固定値になります。 InkAndGesture モードでは、ジェスチャ認識が高速になります。 InkAndGesture モードでインクが収集されないようにするには、次の手順を実行します。

  1. CollectionMode プロパティを InkAndGesture に設定します。
  2. Stroke イベントで、ストロークを削除します。
  3. Gesture イベントで、ジェスチャを処理します。
  4. [DynamicRendering] を [FALSE] に設定すると、ゲスティング中のインクの流れを防ぐことができます。

要件

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

こちらもご覧ください

CollectingInk プロパティ

Enabled プロパティ

IInkCollector

InkCollectionMode 列挙

InkCollector クラス