Renderer.Measure-Methode (Strokes)

Artikel
10/28/2008

Berechnet das Rectangle im Gerätekontext zur Aufnahme der Strokes-Auflistung, die mit der Draw-Methode des Renderer-Objekts gezeichnet wird.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function Measure ( _
    strokes As Strokes _
) As Rectangle
'Usage
Dim instance As Renderer
Dim strokes As Strokes
Dim returnValue As Rectangle

returnValue = instance.Measure(strokes)

public Rectangle Measure(
    Strokes strokes
)

public:
Rectangle Measure(
    Strokes^ strokes
)

public Rectangle Measure(
    Strokes strokes
)

public function Measure(
    strokes : Strokes
) : Rectangle

Parameter

strokes
Typ: Microsoft.Ink.Strokes
Die zu messende Strokes-Auflistung.

Rückgabewert

Typ: System.Drawing.Rectangle
Das Rectangle im Gerätekontext zur Aufnahme der
Striche, wenn die Striche mit der Draw-Methode des Renderer-Objekts gezeichnet wurden. Zur Berechnung des Rechtecks müssen die Striche x-Koordinaten und y-Koordinaten enthalten. Andernfalls gibt die Methode ein leeres Rechteck zurück.

Hinweise

Diese Methode ist nur präzise, wenn Sie an die Measure-Methode und die Draw-Methode dieselben Argumente übergeben.

Da sich die Stiftbreite auf das umgebende Rechteck auswirkt, wird diese Breite entsprechend für die Ansichtstransformation des Renderer-Objekts skaliert. Zu diesem Zweck wird die Stiftbreite mit der Quadratwurzel der Determinanten der Ansichtstransformation multipliziert. Die Höhe und Breite des umgebenden Rechtecks werden in jede Richtung um die Hälfte dieses Betrags erweitert, und die rechte und untere Seite werden um eins erhöht.

Angenommen, die Stiftbreite beträgt ursprünglich 53, die Quadratwurzel der Determinante der Ansichtstransformation ist 50, und das umgebende Rechteck ist (0, 0, 1000, 1000). Die Anpassung der Stiftbreite an das umgebende Rechteck in jede Richtung wird als (53 * 50) / 2 berechnet, und die rechte und untere Seite werden um eins erhöht. Dies führt zu dem gerenderten umgebenden Rechteck (-1325, -1325, 2326, 2326).

Beispiele

In diesem C#-Beispiel wird das umgebende Rechteck für die Strokes-Auflistung im InkCollector-Objekt mit dem Namen theInkCollector abgerufen.

Rectangle theMeasure = theInkCollector.Renderer.Measure(theInkCollector.Ink.Strokes);

In diesem Microsoft® Visual Basic® .NET-Beispiel wird das umgebende Rechteck für die Strokes-Auflistung im InkCollector-Objekt theInkCollector abgerufen.

Dim theMeasure As Rectangle = theInkCollector.Renderer.Measure(theInkCollector.Ink.Strokes)

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.