Freigeben über


Renderer.Draw-Methode (Graphics, Strokes)

Zeichnet die Strokes-Auflistung auf der angegebenen Graphics-Oberfläche.

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

Syntax

'Declaration
Public Sub Draw ( _
    g As Graphics, _
    strokes As Strokes _
)
'Usage
Dim instance As Renderer
Dim g As Graphics
Dim strokes As Strokes

instance.Draw(g, strokes)
public void Draw(
    Graphics g,
    Strokes strokes
)
public:
void Draw(
    Graphics^ g, 
    Strokes^ strokes
)
public void Draw(
    Graphics g,
    Strokes strokes
)
public function Draw(
    g : Graphics, 
    strokes : Strokes
)

Parameter

Hinweise

Hinweis

Verwenden Sie nach Möglichkeit statt einer Überladung, die ein IntPtr akzeptiert, die entsprechende Überladung, die ein Graphics-Objekt akzeptiert.

Die Stiftbreite wird entsprechend der Verwendung der SetViewTransform-Methode angepasst. Insbesondere wird die Stiftbreite mit der Quadratwurzel der Determinanten der Ansichtstransformation multipliziert (bzw. skaliert).

Hinweis

Wenn die Stiftbreite nicht explizit festgelegt wurde, beträgt sie standardmäßig 53. Sie müssen die Stiftbreite mit der Quadratwurzel der Determinanten multiplizieren, um das ordnungsgemäße umgebende Rechteck zu erhalten. Die Höhe und Breite des umgebenden Rechtecks werden in jede Richtung um die Hälfte dieses Betrags erweitert.

Angenommen, die Stiftbreite beträgt 53, die Quadratwurzel der Determinante 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).

Das Renderer-Objekt erzwingt, dass der Ursprung von Viewports und Fenstern auf 0,0 festgelegt wird. Alle vorhandenen Einstellungen werden gespeichert und wiederhergestellt, jedoch nicht vom Renderer verwendet. Um einen Bildlauf auszuführen, verwenden Sie die GetViewTransform-Methode und die GetObjectTransform-Methode des Renderer-Objekts.

Beispiele

In diesem Beispiel wird die gesamte Strokes-Auflistung aus einem Ink-Objekt, das einem InkOverlay-Objekt zugeordnet ist, in einem Panel angezeigt, das sich von dem dem InkOverlay-Objekt zugeordneten unterscheidet. Dies wird durch Aufrufen der Draw-Methode erreicht, die dem g-Parameter ein anderes Graphics-Objekt übergibt als das Objekt, das dem InkOverlay-Objekt zugeordnet ist.

' Access to the Ink.Strokes property returns a copy of the Strokes object.
' This copy must be implicitly (via using statement) or explicitly
' disposed of in order to avoid a memory leak.
Using allStrokes As Strokes = mInkOverlay.Ink.Strokes
    ' get a graphics object for another panel
    Using g As Graphics = Me.panelForDraw.CreateGraphics()
        ' get a Renderer object. We could have used
        ' mInkOverlay.Renderer, this is another way
        Dim R As Renderer = New Renderer()
        ' draw the strokes
        R.Draw(g, allStrokes)
    End Using
End Using
// Access to the Ink.Strokes property returns a copy of the Strokes object.
// This copy must be implicitly (via using statement) or explicitly
// disposed of in order to avoid a memory leak.
using (Strokes allStrokes = mInkOverlay.Ink.Strokes)
{
    // get a graphics object for another panel
    using (Graphics g = this.panelForDraw.CreateGraphics())
    {
        // get a Renderer object. We could have used
        // mInkOverlay.Renderer, this is another way
        Renderer R = new Renderer();
        // draw the strokes
        R.Draw(g, allStrokes);
    }
}

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.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

Renderer-Klasse

Renderer-Member

Draw-Überladung

Microsoft.Ink-Namespace

Renderer.SetViewTransform

DrawingAttributes

Strokes

Stroke