Stroke.Clip (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Quita las partes del objeto Stroke 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 Stroke
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
Rectángulo respecto al cual se recorta cada objeto Stroke.

Comentarios

El parámetro r se especifica en coordenadas de espacio 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, se modifican todos los objetos Stroke seleccionados de un objeto InkOverlay. Primero, se llama al método GetBoundingBox para determinar el rectángulo delimitador de un objeto Stroke seleccionado. A continuación, el rectángulo resultante se modifica para que tenga la mitad del ancho que el original. A continuación, se llama al método Clip para recortar la mitad derecha de Stroke.

For Each S As Stroke In mInkOverlay.Selection
    Dim sBounds As Rectangle = S.GetBoundingBox()
    ' decrease width by half
    sBounds.Width -= sBounds.Width / 2
    ' clip the stroke
    S.Clip(sBounds)
Next

foreach (Stroke S in mInkOverlay.Selection)
{
    Rectangle sBounds = S.GetBoundingBox();
    // decrease width by half
    sBounds.Width -= sBounds.Width / 2;
    // clip the stroke
    S.Clip(sBounds);
}

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.