Strokes.Add, méthode (Stroke)

Article
11/05/2008

Mise à jour : November 2007

Ajoute un objet Stroke à la collection Strokes.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Function Add ( _
    stroke As Stroke _
) As Integer
'Utilisation
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

Paramètres

stroke
Type : Microsoft.Ink.Stroke
Stroke à ajouter à la collectionStrokes.

Valeur de retour

Type : System.Int32
Cette méthode retourne toujours la valeur -1.

Notes

L'objet Stroke doit déjà exister dans l'objet Ink et ne peut pas appartenir à un autre objet Ink. De plus, cette méthode ne copie pas et ne modifie pas l'objet Ink, mais ajoute simplement ce Stroke à la collection Strokes. Si vous appelez cette méthode avec un objet Stroke que la collection Strokes contient déjà, l'objet Stroke ne sera plus ajouté, et aucune exception ne sera levée.

Exemples

Dans cet exemple, un objet Stroke est ajouté à une nouvelle collection Strokes. Cette collection est à son tour ajoutée à une autre collection Strokes. L'objet Ink passé à la méthode d'exemple est utilisé pour créer des collections Strokes et des objets Stroke. Lorsque vous créez un objet Stroke en appelant la méthode CreateStroke, le nouveau Stroke est automatiquement ajouté à la collection Strokes() principale de l'objet Ink. De plus, comme indiqué dans cet exemple, le nouvel objet Stroke peut être ajouté à d'autres collections 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);
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.