Divider.Divide メソッド

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

Divider オブジェクトの Strokes プロパティに関する構成情報を含む DivisionResult オブジェクトを返します。

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

構文

'宣言
Public Function Divide As DivisionResult
'使用
Dim instance As Divider
Dim returnValue As DivisionResult

returnValue = instance.Divide()

public DivisionResult Divide()

public:
DivisionResult^ Divide()

public DivisionResult Divide()

public function Divide() : DivisionResult

戻り値

型 : Microsoft.Ink.DivisionResult
Divider オブジェクトの Strokes プロパティに関する構成情報を含む DivisionResult オブジェクトを返します。

解説

このメソッドが呼び出されるたびに、このメソッドは新しい DivisionResult オブジェクトを返します。

Divide メソッドの戻り値には、Divider オブジェクトの Strokes プロパティのレイアウト分析結果が格納されます。

例

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

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