Freigeben über


Stroke.Split-Methode

Teilt das Stroke-Objekt an der angegebenen Position auf dem Stroke-Objekt und gibt das neue Stroke-Objekt zurück.

Namespace:  Microsoft.Ink
Assembly:  Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function Split ( _
    findex As Single _
) As Stroke
'Usage
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

Parameter

  • findex
    Typ: System.Single
    Der Gleitkommaindexwert, der angibt, wo das Stroke-Objekt geteilt werden soll.

Rückgabewert

Typ: Microsoft.Ink.Stroke
Das neue Stroke-Objekt, das aus dem Aufruf dieser Methode resultiert.

Hinweise

Ein Gleitkommaindex ist ein Gleitkommawert, der eine beliebige Position zwischen zwei Punkten im Strich darstellt. Beispiele: Wenn 0,0 der erste Punkt im Strich und 1,0 der zweite Punkt im Strich ist, liegt 0,5 genau in der Mitte zwischen dem ersten und dem zweiten Punkt. Ebenso stellt ein Gleitkommaindexwert von 37,25 eine Position dar, die sich 25 Prozent entlang der Zeile zwischen den Punkten 37 und 38 des Strichs befindet.

Wenn ein Stroke-Objekt geteilt wird, dann behält ein Teil des Strichs die Id-Eigenschaft des ursprünglichen Stroke-Objekts bei. Der andere Teil des Stroke-Objekts wird zu einem neuen Stroke-Objekt mit einer Id-Eigenschaft, deren Wert um eins größer als der größte vorhandene Id-Eigenschaftswert ist. Wenn sich das ursprüngliche Stroke-Objekt in einer Strokes-Auflistung befindet (die nicht mit Ink.Strokes identisch ist), dann bleibt nur der Anfangsteil in dieser Auflistung.

Beispiele

In diesem Beispiel wird jedes ausgewählte Stroke-Objekt eines InkOverlay überprüft. Wenn der Stroke über mindestens einen Schnittpunkt mit den restlichen Elementen der Strokes-Auflistung im Ink-Objekt verfügt, wird der Stroke am ersten Schnittpunkt geteilt.

' 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]);
        }
    }
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

Stroke-Klasse

Stroke-Member

Microsoft.Ink-Namespace