Stroke.SetPoints メソッド (array<Point[])

[アーティクル]
10/28/2008

Stroke オブジェクト内の最初のインデックスから始まる Point 構造体の範囲を設定します。

名前空間 : 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 オブジェクト内のポイントを置き換える、新しい Point 値の配列。
配列。

戻り値

型 : System.Int32
設定されたポイントの実際の数を返します。

解説

このメソッドは、この Stroke オブジェクト内のポイントの数を変更しません。Stroke オブジェクト内のポイントの数を変更するには、新しい Stroke オブジェクトを作成するか、Stroke オブジェクトを分割する必要があります。

ポイント配列の長さにより、Stroke オブジェクト内の変更するポイントの数が決まります。

このメソッドは、Stroke オブジェクトの切り捨ては行いません。ポイント配列に含まれているポイントが Stroke オブジェクトより少ない場合、Stroke オブジェクト内の残りのポイントは変更されません。

このメソッドは、Stroke オブジェクトの拡張は行いません。ポイント配列に含まれているポイントが Stroke オブジェクトより多い場合、余分なポイントは使用されません。

例

この例では、InkOverlay で選択された各 Stroke オブジェクトが、Stroke のすべてのポイントを取得し、それぞれの Y 座標をストロークの最初の Y 座標に一致するように設定することによって、水平ストロークに変更されます。最後に、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);
}