DivisionResult.ResultByType メソッド

2008-10-28

DivisionUnits コレクションの分析結果の要求された構造単位を取得します。

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

構文

'宣言
Public Function ResultByType ( _
    divisionType As InkDivisionType _
) As DivisionUnits
'使用
Dim instance As DivisionResult
Dim divisionType As InkDivisionType
Dim returnValue As DivisionUnits

returnValue = instance.ResultByType(divisionType)

public DivisionUnits ResultByType(
    InkDivisionType divisionType
)

public:
DivisionUnits^ ResultByType(
    InkDivisionType divisionType
)

public DivisionUnits ResultByType(
    InkDivisionType divisionType
)

public function ResultByType(
    divisionType : InkDivisionType
) : DivisionUnits

パラメータ

divisionType
型 : Microsoft.Ink.InkDivisionType
返す構造単位を示す InkDivisionType 列挙体の値の 1 つ。

戻り値

型 : Microsoft.Ink.DivisionUnits
分析結果の要求された構造単位を含む DivisionUnits コレクションを返します。

解説

このメソッドが呼び出されるたびに、このメソッドは新しい DivisionUnits コレクションを返します。

DivisionResult オブジェクトに要求された型の構造単位が存在しない場合、このメソッドは、空の DivisionUnits コレクションを返します。

例

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