Strokes.Add-Methode (Stroke)

Artikel
11/26/2008

Fügt der Strokes-Auflistung ein Stroke-Objekt hinzu.

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

Syntax

'Declaration
Public Function Add ( _
    stroke As Stroke _
) As Integer
'Usage
Dim instance As Strokes
Dim stroke As Stroke
Dim returnValue As Integer

returnValue = instance.Add(stroke)

public int Add(
    Stroke stroke
)

public:
int Add(
    Stroke^ stroke
)

public int Add(
    Stroke stroke
)

public function Add(
    stroke : Stroke
) : int

Parameter

stroke
Typ: Microsoft.Ink.Stroke
Der Stroke, der zur Strokes-Auflistung hinzugefügt werden soll.

Rückgabewert

Typ: System.Int32
Diese Methode gibt immer den Wert -1 zurück.

Hinweise

Das Stroke-Objekt muss bereits innerhalb des Ink-Objekts vorhanden sein und kann nicht zu einem anderen Ink-Objekt gehören. Zudem kopiert oder ändert diese Methode das Ink-Objekt in keiner Weise, sondern fügt den Stroke einfach der Strokes-Auflistung hinzu. Wenn Sie diese Methode mit einem Stroke-Objekt aufrufen, das bereits in der Strokes-Auflistung enthalten ist, wird das Stroke-Objekt nicht erneut hinzugefügt, und es wird keine Ausnahme ausgelöst.

Beispiele

In diesem Beispiel wird einer neu erstellten Strokes-Auflistung ein Stroke-Objekt hinzugefügt. Diese Auflistung hingegen wird einer anderen Strokes-Auflistung hinzugefügt. Das an die Beispielmethode übergebene Ink-Objekt wird zur Erstellung neuer Strokes-Auflistungen und neuer Stroke-Objekte erstellt. Wenn Sie ein neues Stroke-Objekt durch Aufrufen der CreateStroke-Methode erstellen, wird der neu erstellte Stroke automatisch der Strokes()-Hauptauflistung des Ink-Objekts hinzugefügt. Darüber hinaus kann das neu erstellte Stroke-Objekt (wie in diesem Beispiel gezeigt) anderen Strokes-Auflistungen hinzugefügt werden.

Private Sub AddStrokes(ByVal mInk As Ink)
    ' create a new Strokes collection
    Dim newStrokes1 As Strokes = mInk.CreateStrokes()
    ' create a new Stroke
    Dim points As Point() = {New Point(500, 500), New Point(500, 2500)}
    Dim newStroke As Stroke = mInk.CreateStroke(points)
    ' add the new Stroke to the Strokes collection
    newStrokes1.Add(newStroke)
    ' create another Strokes collection
    Dim newStrokes2 As Strokes = mInk.CreateStrokes()
    ' add the first Strokes collection to the second Strokes collection
    newStrokes2.Add(newStrokes1)
End Sub

private void AddStrokes(Ink mInk)
{ 
    // create a new Strokes collection
    Strokes newStrokes1 = mInk.CreateStrokes();
    // create a new Stroke
    Point[] points = { new Point(500, 500), new Point(500, 2500) };
    Stroke newStroke = mInk.CreateStroke(points);
    // add the new Stroke to the Strokes collection
    newStrokes1.Add(newStroke);
    // create another Strokes collection
    Strokes newStrokes2 = mInk.CreateStrokes();
    // add the first Strokes collection to the second Strokes collection
    newStrokes2.Add(newStrokes1);
}

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.