DivisionUnit.RecognitionString プロパティ

2008-10-28

DivisionUnit オブジェクト内の Strokes コレクションの認識されたテキストを取得します。

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

構文

'宣言
Public ReadOnly Property RecognitionString As String
'使用
Dim instance As DivisionUnit
Dim value As String

value = instance.RecognitionString

public string RecognitionString { get; }

public:
property String^ RecognitionString {
    String^ get ();
}

/** @property */
public String get_RecognitionString()

public function get RecognitionString () : String

プロパティ値

型 : System.String
DivisionUnit オブジェクト内の Strokes コレクションの認識されたテキスト。

解説

RecognitionString プロパティは、描画要素に null を返します。

各型の DivisionUnit オブジェクトの認識されるテキストを次の表に示します。

DivisionUnit 型	RecognitionString 値
Segment	認識セグメントの最上位代替候補。
Line	スペースにより区切られた、行内の各セグメントの RecognizedText。
Paragraph	改行文字により区切られた、段落内の各行の RecognizedText。
Drawing	nullnull 参照 (Visual Basic では Nothing)

RecognitionString プロパティと DivisionUnit.ToString メソッドは、同一の文字列を返します。

例

この C# の例では、Strokes コレクション theStrokes が含まれる Divider オブジェクト theDivider を作成し、RecognizerContext オブジェクト theRecognizerContext を使用します。Divide メソッドは、分析結果 theResult のスナップショットを取得するために呼び出されます。ResultByType メソッドは、theResult 内のすべての行単位を取得するために、Line に設定された divisionType パラメータ、InkDivisionType 列挙子を使用して呼び出されます。コレクション内の theLine 行ごとに、DivisionType、Strokes、RecognitionString、および Transform プロパティが取得されます。

// Create the Divider and assign a Strokes collection to it.
Divider theDivider = new Divider(theStrokes, theRecognizerContext);

// Retrieve the analysis result, and divide the result by line.
DivisionResult theResult = theDivider.Divide();
DivisionUnits theDivisionUnits =
    theResult.ResultByType(InkDivisionType.Line);
foreach (DivisionUnit theLine in theDivisionUnits)
{
    // For each line element in the collection
    // retrieve the division type, the strokes,
    // the recognition string, and the rotation transform.
    InkDivisionType theDivisionType = theLine.DivisionType;
    Strokes elementStrokes = theLine.Strokes;
    string theRecognitionString = theLine.RecognitionString;
    System.Drawing.Drawing2D.Matrix theInkTransform =
        theLine.Transform;
}

この Microsoft® Visual Basic® .NET の例では、Strokes コレクション theStrokes が含まれる Divider オブジェクト theDivider を作成し、RecognizerContext オブジェクト theRecognizerContext を使用します。Divide メソッドは、分析結果 theResult のスナップショットを取得するために呼び出されます。ResultByType メソッドは、theResult 内のすべての行単位を取得するために、Line に設定された divisionType パラメータ、InkDivisionType 列挙子を使用して呼び出されます。コレクション内の theLine 行ごとに、DivisionType、Strokes、RecognitionString、および Transform プロパティが取得されます。

' Create the Divider and assign a Strokes collection to it.
Dim theDivider As Divider = New Divider(theStrokes, theRecognizerContext)

' Retrieve the analysis result, and divide the result by line.
Dim theResult As DivisionResult = theDivider.Divide()
Dim theDivisionUnits As DivisionUnits = _
    theResult.ResultByType(InkDivisionType.Line)
Dim theLine As DivisionUnit
For Each theLine In theDivisionUnits
    ' For each line element in the collection
    ' retrieve the division type, the strokes,
    ' the recognition string, and the rotation transform.
    Dim theDivisionType As InkDivisionType = theLine.DivisionType
    Dim elementStrokes As Strokes = theLine.Strokes
    Dim theRecognitionString As String = theLine.RecognitionString
    Dim theInkTransform As System.Drawing.Drawing2D.Matrix = _
        theLine.Transform
Next