Stroke.SetPoints-Methode (Int32, array<Point[])

Artikel
11/26/2008

Legt den Bereich der Point-Strukturen fest, der beim angegebenen Index in einem Stroke-Objekt beginnt.

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

Syntax

'Declaration
Public Function SetPoints ( _
    index As Integer, _
    points As Point() _
) As Integer
'Usage
Dim instance As Stroke
Dim index As Integer
Dim points As Point()
Dim returnValue As Integer

returnValue = instance.SetPoints(index, _
    points)

public int SetPoints(
    int index,
    Point[] points
)

public:
int SetPoints(
    int index, 
    array<Point>^ points
)

public int SetPoints(
    int index,
    Point[] points
)

public function SetPoints(
    index : int, 
    points : Point[]
) : int

Parameter

index
Typ: System.Int32
Der nullbasierte Index des ersten Punkts im Stroke-Objekt, das geändert werden soll.

points
Typ: array<System.Drawing.Point[]
Das Array neuer Point-Werte, die die Punkte im Stroke-Objekt ersetzen sollen und zwar ab
index.

Rückgabewert

Typ: System.Int32
Gibt die tatsächliche Anzahl der festgelegten Punkte zurück.

Hinweise

Die Anzahl der Punkte im Stroke-Objekt wird mit dieser Methode nicht geändert. Um die Anzahl der Punkte im Stroke-Objekt zu ändern, muss ein neues Stroke-Objekt erstellt oder das Stroke-Objekt muss geteilt werden.

Die Länge des Punktarrays bestimmt die Anzahl der Punkte, die im Stroke-Objekt geändert werden sollen.

Das Stroke-Objekt kann mit dieser Methode nicht abgeschnitten werden. Wenn das Punktarray weniger Punkte umfasst als das Stroke-Objekt, dann werden die restlichen Punkte im Stroke-Objekt nicht geändert.

Das Stroke-Objekt kann mit dieser Methode nicht erweitert werden. Wenn das Punktarray mehr Punkte umfasst als das Stroke-Objekt, dann werden die zusätzlichen Punkte nicht verwendet.

Beispiele

In diesem Beispiel wird die zweite Hälfte jedes ausgewählten Stroke-Elements eines InkOverlay-Objekts in einen horizontalen Strich geändert, indem die Punkte der zweiten Hälfte des Stroke-Elements abgerufen und dann alle Y-Koordinaten standardisiert werden. Nachdem die Werte geändert wurden, wird das Stroke-Objekt mithilfe der SetPoints-Methode aktualisiert.

For Each S As Stroke In mInkOverlay.Selection
    Dim halfwayPt As Integer = S.PacketCount / 2
    ' get the points
    Dim pts() As Point = S.GetPoints(halfwayPt, S.PacketCount - halfwayPt)
    ' set each Y coordinate to the first Y coordinate
    For k As Integer = 0 To pts.Length - 1
        pts(k).Y = pts(0).Y
    Next
    ' update the points
    S.SetPoints(halfwayPt, pts)
Next

foreach (Stroke S in mInkOverlay.Selection)
{
    int halfwayPt = S.PacketCount / 2;
    // get the points
    Point[] pts = S.GetPoints(halfwayPt, S.PacketCount - halfwayPt);
    // set each Y coordinate to the first Y coordinate
    for (int k = 0; k < pts.Length; k++)
    {
        pts[k].Y = pts[0].Y;
    }
    // update the points
    S.SetPoints(halfwayPt, pts);
}

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.