Metodo Ink.GetBoundingBox (BoundingBoxMode)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce l'oggetto Rectangle di delimitazione che contiene tutti gli oggetti Stroke nell'oggetto Ink, utilizzando 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 Ink
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 tratto, ad esempio gli attributi di disegno, vengono utilizzate per calcolare il riquadro dell'input penna.

Valore restituito

Tipo: System.Drawing.Rectangle
Oggetto Rectangle che definisce il riquadro dell'insieme Strokes nell'oggetto Ink.

Note

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

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. Si consideri un esempio in cui 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 dell'oggetto Ink. La modifica apportata all'oggetto Rectangle restituita da questo metodo non influisce sul riquadro dell'oggetto Ink originale.

Nota

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

Esempi

In questo esempio di C# viene restituito l'oggetto Rectangle di delimitazione contenente l'insieme Strokes in un oggetto Ink. L'oggetto Ink è associato a un oggetto InkCollector, theInkCollector. Nell'esempio viene utilizzato il valore CurveFit dell'enumerazione BoundingBoxMode per determinare i limiti del riquadro.

Rectangle theBoundingBox =
    theInkCollector.Ink.GetBoundingBox(BoundingBoxMode.CurveFit);

In questo esempio di Microsoft Visual Basic.NET viene restituito l'oggetto Rectangle di delimitazione contenente l'insieme Strokes in un oggetto Ink. L'oggetto Ink è associato a un oggetto InkCollector, theInkCollector. Nell'esempio viene utilizzato il valore BoundingBoxMode dell'enumerazione BoundingBoxMode per determinare i limiti.

Dim theBoundingBox As Rectangle = _
    theInkCollector.Ink.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.