Metodo Renderer.Measure (Stroke, DrawingAttributes)

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 tramite l'oggetto DrawingAttributes specificato.

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

Sintassi

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

returnValue = instance.Measure(stroke, _
    da)

public Rectangle Measure(
    Stroke stroke,
    DrawingAttributes da
)

public:
Rectangle Measure(
    Stroke^ stroke, 
    DrawingAttributes^ da
)

public Rectangle Measure(
    Stroke stroke,
    DrawingAttributes da
)

public function Measure(
    stroke : Stroke, 
    da : DrawingAttributes
) : Rectangle

Parametri

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

da
Tipo: Microsoft.Ink.DrawingAttributes
Oggetto DrawingAttributes da utilizzare quando si calcola il rettangolo, che esegue l'override della proprietà DrawingAttributes dell'oggetto Stroke.

Valore restituito

Tipo: System.Drawing.Rectangle
Rectangle sul contesto di dispositivo necessario a contenere l'oggetto disegnato 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, theStroke, quando lo spessore della penna raddoppia. L'oggetto Renderer proviene dall'oggetto InkOverlay, theInkOverlay.

DrawingAttributes drawingAtt = theStroke.DrawingAttributes.Clone();
drawingAtt.Width = drawingAtt.Width * 2;
Rectangle bounds = theInkOverlay.Renderer.Measure(theStroke, drawingAtt);

In questo esempio di Microsoft® Visual Basic® .NET si ottiene il rettangolo di delimitazione per un oggetto Stroke, theStroke, quando lo spessore della penna raddoppia. L'oggetto Renderer proviene dall'oggetto InkOverlay, theInkOverlay.

Dim drawingAtt As DrawingAttributes = theStroke.DrawingAttributes.Clone();
drawingAtt.Width = drawingAtt.Width * 2;
Dim bounds As Rectangle = theInkOverlay.Renderer.Measure(theStroke, drawingAtt);

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.