DivisionUnit.Transform (Propiedad)

Artículo
10/28/2008

Actualización: noviembre 2007

Obtiene la matriz de transformación que usa el objeto DivisionUnit para girar los trazos a la posición horizontal.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public ReadOnly Property Transform As Matrix
'Uso
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

Valor de propiedad

Tipo: System.Drawing.Drawing2D.Matrix
Matriz de transformación que usa el objeto DivisionUnit para girar los trazos a la posición horizontal.

Comentarios

Los reconocedores de texto funcionan mejor con la escritura a mano horizontal. Aplique esta transformación a la propiedad Strokes del objeto DivisionUnit antes de pasar los trazos a un objeto RecognizerContext.

El punto de giro de la matriz se establece en la esquina inferior izquierda del cuadro de límite de la línea para segmentos y líneas. El ángulo de rotación de un segmento de reconocimiento es el mismo que el de la línea que contiene el segmento.

Nota

Para un objeto DivisionUnit que representa un párrafo o un dibujo, esta propiedad devuelve la matriz de identidad.

Use esta propiedad para nivelar la escritura a mano o para dibujar con precisión líneas o formas alrededor de la escritura a mano en ángulo.

Ejemplos

En este ejemplo de C# se crea un objeto Divider,theDivider, que contiene una colección StrokestheStrokes y usa un objeto RecognizerContext, theRecognizerContext. El método Divide se invoca para obtener una instantánea de los resultados del análisis, theResult. El método ResultByType se invoca con el parámetro divisionType establecido en Line, una enumeración InkDivisionType, para recuperar todas las unidades de línea de theResult. En cada línea, theLine, de la colección, se recuperan las propiedades DivisionType, Strokes, RecognitionString y 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;
}

En este ejemplo de Microsoft® Visual Basic® .NET se crea un objeto Divider, theDivider, que contiene una colección Strokes, theStrokes, y usa un objeto RecognizerContext, theRecognizerContext. El método Divide se invoca para obtener una instantánea de los resultados del análisis, theResult. El método ResultByType se invoca con el parámetro divisionType establecido en Line, una enumeración InkDivisionType, para recuperar todas las unidades de línea de theResult. En cada línea, theLine, de la colección, se recuperan las propiedades DivisionType, Strokes, RecognitionString y 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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.