RecognizerContext.Strokes プロパティ

[アーティクル]
10/28/2008

RecognizerContext オブジェクトに関連付けられている Strokes コレクションを取得または設定します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Property Strokes As Strokes
'使用
Dim instance As RecognizerContext
Dim value As Strokes

value = instance.Strokes

instance.Strokes = value

public Strokes Strokes { get; set; }

public:
property Strokes^ Strokes {
    Strokes^ get ();
    void set (Strokes^ value);
}

/** @property */
public Strokes get_Strokes()
/** @property */
public  void set_Strokes(Strokes value)

public function get Strokes () : Strokes
public function set Strokes (value : Strokes)

プロパティ値

型 : Microsoft.Ink.Strokes
RecognizerContext オブジェクトに関連付けられている Strokes コレクション。

解説

RecognizerContext オブジェクトで手書き認識を実行するには、Strokes コレクションを RecognizerContext オブジェクトに割り当てる必要があります。このプロパティは、RecognizerContext オブジェクトが RecognitionResult オブジェクトを作成する作成元の Strokes コレクションを維持します。

Strokes コレクションを複数回設定できます。Strokes コレクションを設定するたびに、RecognizerContext オブジェクトはリセットされます。これにより、すべてのインクまたは結果が削除され、EndInkInput メソッドの以前の呼び出しもすべて無視されて、新しいストロークが追加されます。

Strokes コレクションを nullnull 参照 (Visual Basic では Nothing) に設定することにより RecognizerContext オブジェクトをリセットすることもできます。RecognizerContext がリセットされても、認識ガイド、擬似事実、および既に設定済みの他のプロパティは維持されます。

RecognizerContext オブジェクトがリセットされると、バックグラウンドスレッドで発生するすべての認識がキャンセルされます。

RecognizerContext オブジェクトの Strokes プロパティと Ink オブジェクトに関連付けられたストロークとの同期を維持するには、Ink オブジェクトの InkAdded イベントと InkDeleted イベントを使用して、RecognizerContext オブジェクトに割り当てられた Strokes コレクションで追加または削除する必要があるストロークをリッスンします。これは、Ink オブジェクトでストロークの追加、削除、クリップ、または分割が行われる場合に使用されます。

メモ :
Ink オブジェクトのストロークで移動、スケーリング、変換が行われても、InkAdded イベントまたは InkDeleted イベントは生成されません。RecognizerContext オブジェクトの Strokes プロパティの同期を維持するには、RecognizerContext オブジェクトのストロークで同じ変換を実行します。

例

この C# の例では、RecognizerContext オブジェクト theRecognizerContext の Strokes プロパティを削除し、他のプロパティには影響を与えずに RecognizerContext オブジェクトをリセットします。

theRecognizerContext.Strokes = null;

この Microsoft® Visual Basic® .NET の例では、RecognizerContext オブジェクト theRecognizerContext の Strokes プロパティを削除し、他のプロパティには影響を与えずに RecognizerContext オブジェクトをリセットします。