Metodo Strokes.GetBoundingBox

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce l'oggetto Rectangle di delimitazione che contiene l'oggetto Stroke, tramite il flag BoundingBoxMode predefinito per determinare i limiti.

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

Sintassi

'Dichiarazione
Public Function GetBoundingBox As Rectangle
'Utilizzo
Dim instance As Strokes
Dim returnValue As Rectangle

returnValue = instance.GetBoundingBox()

public Rectangle GetBoundingBox()

public:
Rectangle GetBoundingBox()

public Rectangle GetBoundingBox()

public function GetBoundingBox() : Rectangle

Valore restituito

Tipo: System.Drawing.Rectangle
Restituisce l'oggetto Rectangle di delimitazione che definisce il riquadro per l'insieme Strokes.

Note

L'oggetto Rectangle di delimitazione si trova nelle coordinate dello spazio di input penna.

L'oggetto Rectangle di delimitazione corrisponde alla parte della visualizzazione da invalidare o ridisegnare in caso di visualizzazione di un insieme Strokes.

Quando lo spessore della penna ha effetto sul riquadro, lo spessore viene ridimensionato in modo adeguato alla trasformazione della visualizzazione dell'oggetto Renderer. A tale scopo, lo spessore della penna viene moltiplicato per la radice quadrata del determinante della trasformazione della visualizzazione.

Nota

Se lo spessore della penna non è stato impostato in modo esplicito, il relativo valore predefinito è 53. È necessario moltiplicare lo spessore della penna per la radice quadrata del determinante per produrre il riquadro corretto. L'altezza e la larghezza del riquadro sono espanse della metà di questa quantità in ogni direzione. Ad esempio, si consideri che lo spessore della penna sia 53, la radice quadrata del determinante sia 50 e il riquadro sia (0, 0, 1000, 1000). La regolazione dello spessore della penna nel riquadro in ogni direzione viene calcolata come (53 * 50) / 2 e i lati destro e inferiore vengono incrementati di uno. Il risultato è un riquadro di cui è stato eseguito il rendering di (-1325, -1325, 2326, 2326).

Nota

L'oggetto Rectangle di delimitazione restituito da questo metodo è una copia del riquadro dell'insieme Strokes. La modifica apportata all'oggetto Rectangle restituito da questo metodo non influisce sul riquadro dell'insieme Strokes originale.

Esempi

In questo esempio, un insieme Strokes di un oggetto InkOverlay viene ritagliato nella metà destra dell'insieme Strokes. Innanzitutto, il rettangolo di delimitazione dell'insieme Strokes viene ottenuto chiamando il metodo GetBoundingBox. Un nuovo rettangolo con la metà destra ritagliata viene quindi creato e passato al metodo 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);
}

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.