Metodo Stroke.GetBoundingBox (BoundingBoxMode)

Articolo
10/29/2008

Aggiornamento: novembre 2007

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

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

Sintassi

'Dichiarazione
Public Function GetBoundingBox ( _
    mode As BoundingBoxMode _
) As Rectangle
'Utilizzo
Dim instance As Stroke
Dim mode As BoundingBoxMode
Dim returnValue As Rectangle

returnValue = instance.GetBoundingBox(mode)

public Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public:
Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public function GetBoundingBox(
    mode : BoundingBoxMode
) : Rectangle

Parametri

mode
Tipo: Microsoft.Ink.BoundingBoxMode
Membro dell'enumerazione BoundingBoxMode che specifica quali caratteristiche di un oggetto Stroke, ad esempio gli attributi di disegno, vengono utilizzate per calcolare il riquadro dell'oggetto Stroke.

Valore restituito

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

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 oggetto Stroke.

Il riquadro viene memorizzato nella cache per tutte le modalità diverse da BoundingBoxMode.

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 viene impostato in modo esplicito, il 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

In Windows Vista e nelle versioni più recenti, l'oggetto GetBoundingBox non prende in considerazione lo spessore del tratto.

Nota

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

Esempi

In questo esempio di C# si ottiene il riquadro tratto da un oggetto Stroke, theStroke. Nell'esempio viene utilizzato il valore CurveFit dell'enumerazione BoundingBoxMode per determinare i limiti del riquadro.

Rectangle theBoundingBox = theStroke.GetBoundingBox(BoundingBoxMode.CurveFit);

In questo esempio di Microsoft Visual Basic .NET si ottiene il riquadro tratto da un oggetto Stroke, theStroke. Nell'esempio viene utilizzato il valore BoundingBoxMode dell'enumerazione BoundingBoxMode per determinare i limiti del riquadro.

Dim theBoundingBox As Rectangle = theStroke.GetBoundingBox(BoundingBoxMode.CurveFit)

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.