Metodo Stroke.Clip

Articolo
10/29/2008

Aggiornamento: novembre 2007

Rimuove le parti dell'oggetto Stroke che si trovano all'esterno di un rettangolo specificato.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Sub Clip ( _
    r As Rectangle _
)
'Utilizzo
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
)

Parametri

r
Tipo: System.Drawing.Rectangle
Rettangolo all'esterno del quale ogni oggetto Stroke viene ritagliato.

Note

Il parametro r viene specificato nelle coordinate dello spazio di input penna.

Questo metodo aggiorna l'oggetto Ink padre. Tutte le volte che l'input penna viene rimosso da un oggetto Ink, tutti gli oggetti Stroke o insiemi Strokes definiti per quell'oggetto Ink possono essere invalidati.

Dopo avere chiamato il metodo Clip, le proprietà di ogni oggetto Stroke possono cambiare. Ad esempio, quando un oggetto Stroke inizia all'interno dell'area del rettangolo di ritaglio, esce da tale rettangolo e quindi ritorna al suo interno; si ottengono due oggetti Stroke, di cui almeno uno dispone di una nuova proprietà Id. Nonostante questo comportamento, viene garantita l'unicità di tutte le proprietà Id all'interno di un oggetto Ink, anche se cambiano. Anche altre proprietà dell'oggetto Stroke possono essere sottoposte a modifiche simili.

Esempi

In questo esempio, ogni oggetto Stroke selezionato di un oggetto InkOverlay viene modificato. Innanzitutto, viene chiamato il metodo GetBoundingBox per determinare il rettangolo di delimitazione per un oggetto Stroke selezionato. Il rettangolo risultante viene quindi modificato affinché la relativa larghezza si dimezzi rispetto all'originale. Successivamente, viene chiamato il metodo Clip per ritagliare la metà destra dell'oggetto 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);
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.