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

Artículo
10/28/2008

Actualización: noviembre 2007

Extrae el todos los objetos Stroke dentro de los límites de un rectángulo especificado del objeto Ink cortándolos o copiándolos, como se especifique, y devuelve un nuevo objeto Ink que contiene la colección Strokes extraída.

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

Sintaxis

'Declaración
Public Function ExtractStrokes ( _
    extractionRectangle As Rectangle, _
    extractionFlags As ExtractFlags _
) As Ink
'Uso
Dim instance As Ink
Dim extractionRectangle As Rectangle
Dim extractionFlags As ExtractFlags
Dim returnValue As Ink

returnValue = instance.ExtractStrokes(extractionRectangle, _
    extractionFlags)

public Ink ExtractStrokes(
    Rectangle extractionRectangle,
    ExtractFlags extractionFlags
)

public:
Ink^ ExtractStrokes(
    Rectangle extractionRectangle, 
    ExtractFlags extractionFlags
)

public Ink ExtractStrokes(
    Rectangle extractionRectangle,
    ExtractFlags extractionFlags
)

public function ExtractStrokes(
    extractionRectangle : Rectangle, 
    extractionFlags : ExtractFlags
) : Ink

Parámetros

extractionRectangle
Tipo: System.Drawing.Rectangle
El rectángulo Rectangle que delimita la entrada manuscrita que se va a extraer del objeto Ink.

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 objetos Stroke delimitados por el rectángulo Rectangle especificado (2000 x 2000 unidades HIMETRIC). 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.

Dim R As Rectangle = New Rectangle(0, 0, 2000, 2000)
Dim newInk As Ink = mInkOverlay.Ink.ExtractStrokes(R, ExtractFlags.CopyFromOriginal)

Rectangle R = new Rectangle(0, 0, 2000, 2000);
Ink newInk = mInkOverlay.Ink.ExtractStrokes(R, 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.