Metodo Renderer.Measure (Stroke)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Calcola l'oggetto Rectangle sul contesto di dispositivo necessario a contenere l'oggetto Stroke da disegnare con il metodo Draw dell'oggetto Renderer.

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

Sintassi

'Dichiarazione
Public Function Measure ( _
    stroke As Stroke _
) As Rectangle
'Utilizzo
Dim instance As Renderer
Dim stroke As Stroke
Dim returnValue As Rectangle

returnValue = instance.Measure(stroke)

public Rectangle Measure(
    Stroke stroke
)

public:
Rectangle Measure(
    Stroke^ stroke
)

public Rectangle Measure(
    Stroke stroke
)

public function Measure(
    stroke : Stroke
) : Rectangle

Parametri

stroke
Tipo: Microsoft.Ink.Stroke
Oggetto Stroke da misurare.

Valore restituito

Tipo: System.Drawing.Rectangle
Rectangle sul contesto di dispositivo necessario a contenere i tratti se questi fossero disegnati con il metodo Draw dell'oggetto Renderer. Il tratto deve includere le coordinate X e le coordinate Y per calcolare il rettangolo. In caso contrario, il metodo restituisce un rettangolo vuoto.

Note

Questo metodo funziona correttamente solo se si passano gli stessi argomenti a entrambi i metodi Measure e Draw.

Poiché lo spessore della penna influisce sul riquadro, 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. L'altezza e la larghezza del riquadro vengono espanse della metà di questa quantità in ogni direzione e i lati destro e inferiore vengono incrementati di uno.

Ad esempio, si consideri che lo spessore della penna originariamente sia 53, la radice quadrata del determinante della trasformazione della visualizzazione 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).

Esempi

In questo esempio di C# si ottiene il rettangolo di delimitazione per un oggetto Stroke creato da Ink.CreateStroke, tramite una matrice di oggetti Point, points. L'oggetto Ink e l'oggetto Renderer provengono dall'oggetto InkOverlay, theInkOverlay.

Stroke createdStroke = theInkOverlay.Ink.CreateStroke(points);
Rectangle bounds = theInkOverlay.Renderer.Measure(createdStroke);

In questo esempio di Microsoft® Visual Basic® .NET si ottiene il rettangolo di delimitazione per un oggetto Stroke creato da Ink.CreateStroke, tramite una matrice di oggetti Point, points. L'oggetto Ink e l'oggetto Renderer provengono dall'oggetto InkOverlay, theInkOverlay.

Dim createdStroke As Stroke = theInkOverlay.Ink.CreateStroke(points)
Dim bounds As Rectangle = theInkOverlay.Renderer.Measure(createdStroke)

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.