Ink.ExtractStrokes, méthode (Strokes)

Article
11/05/2008

Mise à jour : November 2007

Extrait les objets Stroke spécifiés de l'objet Ink et retourne un nouvel objet Ink contenant les objets Stroke extraits.

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

Syntaxe

'Déclaration
Public Function ExtractStrokes ( _
    strokes As Strokes _
) As Ink
'Utilisation
Dim instance As Ink
Dim strokes As Strokes
Dim returnValue As Ink

returnValue = instance.ExtractStrokes(strokes)

public Ink ExtractStrokes(
    Strokes strokes
)

public:
Ink^ ExtractStrokes(
    Strokes^ strokes
)

public Ink ExtractStrokes(
    Strokes strokes
)

public function ExtractStrokes(
    strokes : Strokes
) : Ink

Paramètres

strokes
Type : Microsoft.Ink.Strokes
Collection Strokes à extraire.

Valeur de retour

Type : Microsoft.Ink.Ink
Retourne un objet Ink qui contient la collection Strokes extraite.

Notes

Le nouvel objet Ink conserve les attributs de dessin, les propriétés et les coordonnées de l'objet Ink d'origine.

Le comportement par défaut de cette méthode est de supprimer la collection Strokes de l'objet Ink d'origine. Pour conserver la collection Strokes dans l'objet Ink d'origine et créer une copie de Ink, appelez la surcharge ExtractStrokes ou ExtractStrokes de cette méthode en affectant la valeur CopyFromOriginal de l'énumération ExtractFlags au paramètre extractionFlags.

Exemples

Dans cet exemple, le nouvel objet Ink créé contient les deux premiers objets Stroke d'un objet InkOverlay. Les objets Stroke extraits sont supprimés de l'objet Ink d'origine associé à l'objet InkOverlay.

' Access to the Strokes property returns a copy of the Strokes object.
' This copy must be implicitly (via using statement) or explicitly
' disposed of in order to asub a memory leak.
Using allStrokes As Strokes = mInkOverlay.Ink.Strokes
    If (allStrokes.Count > 2) Then
        Dim temp As Strokes = allStrokes.Ink.CreateStrokes()
        temp.Add(allStrokes(0))
        temp.Add(allStrokes(1))
        Dim newInk As Ink = allStrokes.Ink.ExtractStrokes(temp)
    End If
End Using

// Access to the Strokes property returns a copy of the Strokes object.
// This copy must be implicitly (via using statement) or explicitly
// disposed of in order to avoid a memory leak.
using (Strokes allStrokes = mInkOverlay.Ink.Strokes)
{
    if (allStrokes.Count > 2)
    {
        Strokes temp = allStrokes.Ink.CreateStrokes();
        temp.Add(allStrokes[0]);
        temp.Add(allStrokes[1]);
        Ink newInk = allStrokes.Ink.ExtractStrokes(temp);
    }
}

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.