IInkOverlay::get_CollectionMode メソッド (msinkaut.h)
インク、ジェスチャ、またはその両方がユーザーの書き込み時に認識されるかどうかを決定するコレクション モードを取得または設定します。
このプロパティは読み取り/書き込み可能です。
構文
HRESULT get_CollectionMode(
InkCollectionMode *Mode
);
パラメーター
Mode
戻り値
なし
解説
使用できるモードの一覧については、 InkCollectionMode 列挙の種類に関するページを参照してください。 ただし、Microsoft Windows がインストールされているシステムで CollectionMode プロパティを使用する場合は、 XP Tablet PC Edition Software Development Kit (SDK) がインストールされていますが、認識エンジンがインストールされていない場合、モードを GestureOnly または InkAndGesture に設定することはできません。
InkOnly モード
- インクのみが収集されます。ジェスチャはされません。
- ジェスチャ イベントの対象は FALSE に設定されます (他のすべてのイベントの関心は、そのまま残ります)。
GestureOnly モード
- ジェスチャのみが収集されます。インクが表示されません。 ストロークは、ジェスチャ認識エンジンに送信された後に削除されます。
- ジェスチャ イベントの対象は TRUE に設定されます (他のすべてのイベントの関心は、そのまま残ります)。
- インク コレクターは、CursorDown、Stroke、NewPackets、および NewInAirPackets イベントというストロークおよびパケット関連のイベントを起動しません。
- カーソル イベントが発生します。
- インクは常に削除されます。
InkAndGesture モード
- インクとジェスチャの両方が収集されます。
- 1 回のストローク ジェスチャのみが認識されます。
- ジェスチャ イベントの対象は TRUE に設定されます (他のすべてのイベントの関心は、そのまま残ります)。
- ジェスチャ イベントが最初に発生し、ジェスチャを受け入れるか取り消せるようにします。 ジェスチャを取り消すには、 Cancel パラメーターを TRUE に設定します。 ジェスチャをキャンセルすると、インク コレクターは強制的にインクを収集します。
CollectionMode が InkAndGesture に設定され、既知のジェスチャに対するオブジェクト/コントロールの関心が (SetGestureStatus メソッドを呼び出すことによって) 設定されている場合、望ましくない動作が発生する可能性があります。 既知のジェスチャのように見えるインクを描画し、既知のジェスチャが認識エンジンの代替候補の一覧にある場合、 ジェスチャ イベントが発生し、ジェスチャが上部の代替ではない場合でもインクが消えます。 インクが消えないようにし、ジェスチャのコレクションを取り消すには、イベントが関心のないイベントである場合は 、Cancel パラメーターを TRUE に 設定します。
CollectionMode が GestureOnly に設定されている場合、ユーザーがジェスチャを追加してから Gesture イベントが発生した場合のタイムアウトは、プログラムで変更できない固定値です。 InkAndGesture モードでは、ジェスチャ認識が高速になります。 InkAndGesture モードでインクが収集されないようにするには、次の手順を実行します。
- CollectionMode プロパティを InkAndGesture に設定します。
- Stroke イベントで、ストロークを削除します。
- Gesture イベントで、ジェスチャを処理します。
- [DynamicRendering] を FALSE に設定すると、ゲストリング中のインクの流れを防ぐことができます。
要件
| サポートされている最小のクライアント | Windows XP Tablet PC Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |