Stroke.SetPoints 方法 (array<Point[])

發行項
10/29/2008

設定點 (英文) 結構的範圍，從 Stroke 物件中的第一個索引開始。

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public Function SetPoints ( _
    points As Point() _
) As Integer
'用途
Dim instance As Stroke
Dim points As Point()
Dim returnValue As Integer

returnValue = instance.SetPoints(points)

public int SetPoints(
    Point[] points
)

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

public int SetPoints(
    Point[] points
)

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

參數

points
型別：array<System.Drawing.Point[]
新點 (英文) 值的陣列，用來取代 Stroke 物件中下列位置開始的點：
第一個點。

傳回值

型別：System.Int32
傳回設定的實際點數。

備註

這個方法不會變更 Stroke 物件中的點數。若要變更 Stroke 物件中的點數，必須建立新的 Stroke 物件，或是必須分割 Stroke 物件。

點陣列的長度決定了 Stroke 物件中要修改的點數。

這個方法不會提供用來截斷 Stroke 物件。如果點陣列包含的點少於 Stroke 物件，則會修改 Stroke 物件中其餘的點。

這個方法不會提供用來延伸 Stroke 物件。如果點陣列包含的點多於 Stroke 物件，則不會使用額外的點。

範例

在這個範例中，會透過取得 Stroke 的所有點，然後將每個 Y 座標設為符合筆劃的第一個 Y 座標的方式，將 InkOverlay 的每個已選取的 Stroke 物件都變更為水平筆劃。最後會使用 SetPoints 方法更新 Stroke 物件。

For Each S As Stroke In mInkOverlay.Selection
    ' get the points
    Dim pts() As Point = S.GetPoints()
    ' 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(pts)
Next

foreach (Stroke S in mInkOverlay.Selection)
{
    // get the points
    Point[] pts = S.GetPoints();
    // 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(pts);
}