Strokes.Clip (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Quita las partes de cada objeto Stroke de la colección Strokes que están fuera de un rectángulo determinado.

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

Sintaxis

'Declaración
Public Sub Clip ( _
    r As Rectangle _
)
'Uso
Dim instance As Strokes
Dim r As Rectangle

instance.Clip(r)

public void Clip(
    Rectangle r
)

public:
void Clip(
    Rectangle r
)

public void Clip(
    Rectangle r
)

public function Clip(
    r : Rectangle
)

Parámetros

r
Tipo: System.Drawing.Rectangle

Comentarios

El parámetro R se especifica en coordenadas espaciales de entrada manuscrita.

Este método actualiza el objeto Ink primario. Siempre que se quita la entrada manuscrita de un objeto Ink, se pueden invalidar los objetos Stroke o las colecciones Strokes definidas para ese objeto Ink.

Después de llamar al método Clip, las propiedades de cada objeto Stroke pueden cambiar. Por ejemplo, si un objeto Stroke comienza dentro del área del rectángulo de recorte, sale del mismo y vuelve otra vez al rectángulo de recorte; se convierte en dos objetos Stroke y al menos uno de ellos tiene una nueva propiedad Id. A pesar de este comportamiento, se garantiza que todas las propiedades Id son únicas dentro de un objeto Ink, incluso si cambian. Otras propiedades del objeto Stroke también pueden experimentar un cambio similar.

Ejemplos

En este ejemplo, una colección Strokes de un objeto InkOverlay se recorta a la mitad derecha de la colección Strokes. Primero, se obtiene el rectángulo delimitador de la colección Strokes llamando al método GetBoundingBox. A continuación, se crea un nuevo rectángulo con la mitad derecha recortada y se pasa al método Clip.

' 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 allStrokes As Strokes = mInkOverlay.Ink.Strokes
    ' Determine the bounding box for the Strokes collection.
    Dim bounds As Rectangle = allStrokes.GetBoundingBox()
    'Create rectangle for Clip method.
    Dim halfRectangle As Rectangle = _
            New Rectangle(bounds.Left, bounds.Top, bounds.Width / 2, bounds.Height)
    ' Clip the Strokes collection.
    allStrokes.Clip(halfRectangle)
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)
{
    // Determine the bounding box for the Strokes collection.
    Rectangle bounds = allStrokes.GetBoundingBox();
    //Create rectangle for Clip method.
    Rectangle halfRectangle = 
        new Rectangle(bounds.Left, bounds.Top, bounds.Width / 2, bounds.Height);
    // Clip the Strokes collection.
    allStrokes.Clip(halfRectangle);
}

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.