Strokes.Add (Método) (Stroke)

Artículo
10/28/2008

Actualización: noviembre 2007

Agrega un objeto Stroke a la colección Strokes.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Function Add ( _
    stroke As Stroke _
) As Integer
'Uso
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

Parámetros

stroke
Tipo: Microsoft.Ink.Stroke
Objeto Stroke que se va a agregar a la colección Strokes.

Valor devuelto

Tipo: System.Int32
Este método siempre devuelve un valor de -1.

Comentarios

El objeto Stroke ya debe existir dentro del objeto Ink y no puede pertenecer a otro objeto Ink. Además, este método no copia ni modifica de otro modo el objeto Ink, si no que meramente agrega este objeto Stroke a la colección Strokes. Si llama a este método con un objeto Stroke que ya está incluido en la colección Strokes, el objeto Stroke no se agregará de nuevo, y no se producirá ninguna excepción.

Ejemplos

En este ejemplo, se agrega un objeto Stroke a una colección Strokes creada recientemente. Esta colección se agrega a su vez a otra colección Strokes. El objeto Ink pasado al método de ejemplo se utiliza para crear nuevas colecciones Strokes y nuevos objetos Stroke. Al crear un nuevo objeto Stroke llamando al método CreateStroke, el objeto Stroke recién creado se agrega automáticamente a la colección Strokes() la principal del objeto Ink. Además, como se muestra en este ejemplo, el objeto Stroke creado recientemente se puede agregar a otras colecciones 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);
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.