DivisionUnit.Transform 属性

项目
10/28/2008

获取 DivisionUnit 对象用于将笔画旋转至水平的变换矩阵。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public ReadOnly Property Transform As Matrix
用法
Dim instance As DivisionUnit
Dim value As Matrix

value = instance.Transform

public Matrix Transform { get; }

public:
property Matrix^ Transform {
    Matrix^ get ();
}

/** @property */
public Matrix get_Transform()

public function get Transform () : Matrix

属性值

类型：System.Drawing.Drawing2D.Matrix
DivisionUnit 对象用于将笔画旋转至水平的变换矩阵。

备注

文本识别器 处理水平手写时效果最好。在将笔画传递给 RecognizerContext 对象之前，将对 DivisionUnit 对象的 Strokes 属性应用此变换。

无论是识别段还是行，该矩阵的旋转点都设置为行边界框的左下角。识别段 的旋转角度与包含该识别段的行的旋转角度相同。

备注

对于表示段落或绘制的 DivisionUnit 对象，此属性返回单位矩阵。

此属性可用于确定手写文本的水平角度，或在呈一定角度的手写文本周围精确地绘制线或图形。

示例

此 C# 示例创建一个 Divider 对象 theDivider，该对象包含 Strokes 集合 theStrokes，并使用 RecognizerContext 对象 theRecognizerContext。将调用 Divide 方法以获取分析结果 theResult 的快照。将调用 ResultByType 方法，调用时将 divisionType 参数设置为一个 InkDivisionType 枚举 Line，以检索 theResult 中的所有行单元。对于集合中的每一行 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(R) Visual Basic(R) .NET 示例创建一个 Divider 对象 theDivider，该对象包含 Strokes 集合 theStrokes，并使用 RecognizerContext 对象 theRecognizerContext。将调用 Divide 方法以获取分析结果 theResult 的快照。将调用 ResultByType 方法，调用时将 divisionType 参数设置为一个 InkDivisionType 枚举 Line，以检索 theResult 中的所有行单元。对于集合中的每一行 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