Strokes.Add 方法 (Stroke)

项目
11/04/2008

在 Strokes 集合中添加一个 Stroke 对象。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public Function Add ( _
    stroke As Stroke _
) As Integer
用法
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

参数

stroke
类型：Microsoft.Ink.Stroke
要添加到 Strokes 集合的 Stroke。

返回值

类型：System.Int32
此方法每次返回值 –1。

备注

Stroke 对象必须已在 Ink 对象中，并且不能属于其他 Ink 对象。此外，此方法不复制或按照其他方式修改 Ink 对象，而仅将该 Stroke 添加到 Strokes 集合。如果对 Strokes 集合中某个已有的 Stroke 对象调用此方法，则不会再次添加该 Stroke 对象，并且不会引发异常。

示例

此示例将 Stroke 对象添加到新创建的 Strokes 集合。此集合反过来添加到其他 Strokes 集合中。传递给示例方法的 Ink 对象用于创建新的 Strokes 集合和新的 Stroke 对象。通过调用 CreateStroke 方法创建新的 Stroke 对象时，新创建的 Stroke 自动添加到 Ink 对象的主 Strokes() 集合。此外，如此示例所示，新创建的 Stroke 对象可以添加到其他 Strokes 集合中。

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