DivisionUnit.Transform, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient la matrice de transformation que l'objet DivisionUnit utilise pour faire pivoter les traits à l'horizontale.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public ReadOnly Property Transform As Matrix
'Utilisation
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

Valeur de propriété

Type : System.Drawing.Drawing2D.Matrix
Matrice de transformation que l'objet DivisionUnit utilise pour faire pivoter les traits à l'horizontale.

Notes

Les modules de reconnaissance de texte s'exécutent mieux avec une écriture manuscrite horizontale. Appliquez cette transformation à la propriété Strokes de l'objet DivisionUnit avant de passer les traits à un objet RecognizerContext.

Le point de rotation de la matrice a pour valeur l'angle inférieur gauche du cadre englobant de la ligne pour les segments et les lignes. L'angle de rotation d'un segment de reconnaissance est le même que celui de la ligne qui contient le segment.

Remarque :
Pour un objet DivisionUnit qui représente un paragraphe ou un dessin, cette propriété retourne la matrice d'identité.

Utilisez cette propriété pour mettre à niveau l'écriture manuscrite ou pour dessiner des lignes ou des formes de façon précise autour de l'écriture manuscrite selon un angle.

Exemples

Cet exemple C# crée un objet Divider, theDivider, qui contient une collection Strokes, theStrokes et utilise un objet RecognizerContext, theRecognizerContext. La méthode Divide est appelée pour obtenir une capture instantanée des résultats de l'analyse, theResult. La méthode ResultByType est appelée avec le paramètre divisionType ayant pour valeur Line, une énumération InkDivisionType, pour récupérer toutes les unités de ligne dans theResult. Pour chaque ligne, theLine de la collection, les propriétés DivisionType, Strokes, RecognitionString et Transform sont récupérées.

// 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;
}

Cet exemple Microsoft® Visual Basic® .NET crée un objet Divider, theDivider, qui contient une collection Strokes, theStrokes, et utilise un objet RecognizerContext, theRecognizerContext. La méthode Divide est appelée pour obtenir une capture instantanée des résultats de l'analyse, theResult. La méthode ResultByType est appelée avec le paramètre divisionType ayant pour valeur Line, une énumération InkDivisionType, pour récupérer toutes les unités de ligne dans theResult. Pour chaque ligne, theLine de la collection, les propriétés DivisionType, Strokes, RecognitionString et Transform sont récupérées.

' 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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.