Compartir a través de


Ink.ExtractStrokes (Método) (Strokes)

Actualización: noviembre 2007

Extrae los objetos Stroke especificados del objeto Ink 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 _
) As Ink
'Uso
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

Parámetros

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. Los objetos Stroke extraídos se quitan del objeto Ink original asociado al objeto 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);
    }
}

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.

Información de versión

.NET Framework

Compatible con: 3.0

Vea también

Referencia

Ink (Clase)

Ink (Miembros)

ExtractStrokes (Sobrecarga)

Microsoft.Ink (Espacio de nombres)

Strokes

ExtractFlags