Metodo Ink.ExtractStrokes (Strokes, ExtractFlags)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Estrae gli oggetti Stroke specificati dall'oggetto Ink tramite l'operazione di taglio o di copia, come specificato, e restituisce un nuovo oggetto Ink contenente gli oggetti Stroke estratti.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Function ExtractStrokes ( _
    strokes As Strokes, _
    extractionFlags As ExtractFlags _
) As Ink
'Utilizzo
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

Parametri

strokes
Tipo: Microsoft.Ink.Strokes
Insieme Strokes da estrarre.

extractionFlags
Tipo: Microsoft.Ink.ExtractFlags
Uno dei valori di ExtractFlags che specifica se l'input penna è tagliato o è copiato nel nuovo oggetto Ink.

Valore restituito

Tipo: Microsoft.Ink.Ink
Restituisce un oggetto Ink che contiene l'insieme Strokes estratto.

Note

Il nuovo oggetto Ink mantiene gli attributi, le proprietà e le coordinate di disegno dell'oggetto Ink originale.

Il comportamento predefinito per questo metodo consiste nella rimozione dell'insieme Strokes dall'oggetto Ink originale. Per mantenere l'insieme Strokes nell'oggetto Ink originale e fare una copia di Ink, chiamare l'overload ExtractStrokes o ExtractStrokes del metodo con il parametro extractionFlags impostato sul valore CopyFromOriginal dall'enumerazione ExtractFlags.

Esempi

In questo esempio, viene creato un oggetto Ink nuovo contenente i primi due oggetti Stroke di un oggetto InkOverlay. L'insieme Strokes è mantenuto nell'oggetto Ink originale, in quanto il parametro extractionFlags è impostato sul valore CopyFromOriginal dall'enumerazione 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);
    }
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.