Ink.ExtractStrokes, méthode (Strokes, ExtractFlags)

Article
11/05/2008

Mise à jour : November 2007

Extrait les objets Stroke spécifiés de l'objet Ink en les copiant ou en les collant, comme spécifié, 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, _
    extractionFlags As ExtractFlags _
) As Ink
'Utilisation
Dim instance As Ink
Dim strokes As Strokes
Dim extractionFlags As ExtractFlags
Dim returnValue As Ink

returnValue = instance.ExtractStrokes(strokes, _
    extractionFlags)

public Ink ExtractStrokes(
    Strokes strokes,
    ExtractFlags extractionFlags
)

public:
Ink^ ExtractStrokes(
    Strokes^ strokes, 
    ExtractFlags extractionFlags
)

public Ink ExtractStrokes(
    Strokes strokes,
    ExtractFlags extractionFlags
)

public function ExtractStrokes(
    strokes : Strokes, 
    extractionFlags : ExtractFlags
) : Ink

Paramètres

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

extractionFlags
Type : Microsoft.Ink.ExtractFlags
Une des valeurs ExtractFlags qui spécifie si l'entrée manuscrite est coupée ou copiée dans le nouvel objet Ink.

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 du Ink, appelez la surcharge ExtractStrokes ou ExtractStrokes de cette méthode en affectant au paramètre extractionFlags la valeur CopyFromOriginal de l'énumération ExtractFlags.

Exemples

Dans cet exemple, le nouvel objet Ink créé contient les deux premiers objets Stroke d'un objet InkOverlay. La collection Strokes est conservée dans l'objet Ink d'origine, car le paramètre extractionFlags a la valeur CopyFromOriginal de l'énumération ExtractFlags.

' 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, ExtractFlags.CopyFromOriginal)
    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, ExtractFlags.CopyFromOriginal);
    }
}

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.