Ink.ExtractStrokes (Método) (Strokes, ExtractFlags)

Artículo
10/28/2008

Actualización: noviembre 2007

Extrae los objetos Stroke especificados del objeto Ink cortándolos o copiándolos, como se especifique, y devuelve un nuevo objeto Ink que contiene los objetos Stroke extraídos.

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

Sintaxis

'Declaración
Public Function ExtractStrokes ( _
    strokes As Strokes, _
    extractionFlags As ExtractFlags _
) As Ink
'Uso
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

Parámetros

strokes
Tipo: Microsoft.Ink.Strokes
Colección Strokes que se va a extraer.

extractionFlags
Tipo: Microsoft.Ink.ExtractFlags
Uno de los valores de ExtractFlags que especifica si la entrada manuscrita se corta o se copia en el nuevo objeto Ink.

Valor devuelto

Tipo: Microsoft.Ink.Ink
Devuelve un objeto Ink que contiene la colección Strokes extraída.

Comentarios

El nuevo objeto Ink mantiene los atributos, las propiedades y las coordenadas de dibujo del objeto Ink original.

El comportamiento predeterminado de este método consiste en quitar la colección Strokes del objeto Ink original. Para conservar la colección Strokes en su objeto Ink original y hacer una copia de Ink, llame a las sobrecargas ExtractStrokes o ExtractStrokes de este método con el parámetro extractionFlags establecido en el valor CopyFromOriginal de la enumeración ExtractFlags.

Ejemplos

En este ejemplo, se crea un nuevo objeto Ink que contiene los primeros dos objetos Stroke de un objeto InkOverlay. La colección Strokes se conserva en el objeto Ink original, porque el parámetro extractionFlags se establece en el valor CopyFromOriginal de la enumeración 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);
    }
}

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.