Partager via


Stroke.Split, méthode

Mise à jour : November 2007

Fractionne l'objet Stroke à l'emplacement spécifié de l'objet Stroke et retourne le nouvel objet Stroke.

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

Syntaxe

'Déclaration
Public Function Split ( _
    findex As Single _
) As Stroke
'Utilisation
Dim instance As Stroke
Dim findex As Single
Dim returnValue As Stroke

returnValue = instance.Split(findex)
public Stroke Split(
    float findex
)
public:
Stroke^ Split(
    float findex
)
public Stroke Split(
    float findex
)
public function Split(
    findex : float
) : Stroke

Paramètres

  • findex
    Type : System.Single
    Valeur d'index à virgule flottante qui représente l'emplacement où fractionner l'objet Stroke.

Valeur de retour

Type : Microsoft.Ink.Stroke
Objet Stroke créé suite à l'appel à cette méthode.

Notes

L'index à virgule flottante désigne une valeur float qui représente un emplacement situé entre deux points du trait. Par exemple, si 0.0 est le premier point du trait et 1.0 le deuxième, 0.5 est à mi-chemin entre le premier et le deuxième points. De la même façon, une valeur d'index à virgule flottante de 37,25 représente un emplacement qui est situé à 25 % sur la longueur de la ligne entre les points 37 et 38 du trait.

Lorsqu'un Stroke est fractionné, une partie du trait conserve la propriété Id de l'objet Stroke d'origine. L'autre partie du Stroke devient un nouvel objet Stroke avec une propriété Id supérieure à la propriété Id la plus élevée existante. Si le Stroke d'origine était dans une collection Strokes (autre que la propriété Ink.Strokes), seule la partie du début reste dans cette collection.

Exemples

Dans cet exemple, chaque objet Stroke sélectionné d'un InkOverlay est examiné. Si le Stroke a au moins une intersection avec le reste de la collection Strokes de l'objet Ink, le Stroke est fractionné au niveau du premier point d'intersection.

' Access to the Strokes property returns a copy of the Strokes object.
' This copy must be implicitly (via using statement) or explicitly
' disposed of in order to avoid a memory leak.
Using allStrokes As Strokes = mInkOverlay.Ink.Strokes
    For Each S As Stroke In mInkOverlay.Selection
        ' find the intersections
        Dim intersections() As Single = S.FindIntersections(allStrokes)
        ' if we have at least 1 intersection, split the stroke
        If intersections.Length > 0 Then
            S.Split(intersections(0))
        End If
    Next
End Using
// Access to the Strokes property returns a copy of the Strokes object.
// This copy must be implicitly (via using statement) or explicitly
// disposed of in order to avoid a memory leak.
using (Strokes allStrokes = mInkOverlay.Ink.Strokes)
{
    foreach (Stroke S in mInkOverlay.Selection)
    {
        // find the intersections
        float[] intersections = S.FindIntersections(allStrokes);
        // if we have at least 1 intersection, split the stroke
        if (intersections.Length > 0)
        {
            S.Split(intersections[0]);
        }
    }
}

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.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

Stroke, classe

Membres Stroke

Microsoft.Ink, espace de noms