Divider.Divide 方法

發行項
10/29/2008

傳回 DivisionResult 物件，這個物件包含有關 Divider 物件之 Strokes 屬性的結構化資訊。

命名空間： 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
傳回 DivisionResult 物件，這個物件包含有關 Divider 物件之 Strokes 屬性的結構化資訊。

備註

每次呼叫這個方法時，這個方法會傳回新的 DivisionResult 物件。

Divide 方法的傳回值會在 Divider 物件的 Strokes 屬性中儲存配置分析結果。

範例

這個 C# 範例會建立 Divider 物件 (變數名稱為 theDivider)，其中包含 Strokes 集合 (變數名稱為 theStrokes)，並且使用 RecognizerContext 物件 (變數名稱為 theRecognizerContext)。再呼叫 Divide 方法，取得分析結果 theResult 的快照。呼叫 ResultByType 方法時將 divisionType 參數設定為 Line (即 InkDivisionType 列舉型別)，以擷取 theResult 內的所有行單位。針對 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 方法時將 divisionType 參數設定為 Line (即 InkDivisionType 列舉型別)，以擷取 theResult 內的所有行單位。針對 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