Renderer.Draw-Methode (Bitmap, Strokes)

Artikel
11/26/2008

Zeichnet die Strokes-Auflistung in die angegebene Bitmap.

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

Syntax

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

instance.Draw(destinationBitmap, strokes)

public void Draw(
    Bitmap destinationBitmap,
    Strokes strokes
)

public:
void Draw(
    Bitmap^ destinationBitmap, 
    Strokes^ strokes
)

public void Draw(
    Bitmap destinationBitmap,
    Strokes strokes
)

public function Draw(
    destinationBitmap : Bitmap, 
    strokes : Strokes
)

Parameter

destinationBitmap
Typ: System.Drawing.Bitmap
Angegebene Bitmap, in der gezeichnet werden soll.

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

Beispiele

In diesem Beispiel wird die gesamte Strokes-Auflistung aus einem Ink-Objekt, das einem InkOverlay-Objekt zugeordnet ist, in einem Bitmapbild gezeichnet, das aus einer Datei geladen wurde.

Beim Aufrufen der Draw-Methode werden Bild und Striche nicht angezeigt. Stattdessen werden die Strichrenderdaten zur Vorbereitung der Anzeige mit den Bitmapbilddaten zusammengeführt. Das (nun mit Strichrenderdaten geänderte) Bitmapbild wird verfügbar gemacht, indem die DrawImage-Methode des Graphics-Objekts aufgerufen wird, das einem Panel-Objekt zugeordnet ist.

' get the Bitmap object loaded from a file
' scale the image to match the panel size
Dim bgImage As Bitmap = New Bitmap(New Bitmap(imageFileName), Me.panelForDraw.Size)
' place (draw) the stroke collection on the bitmap
' 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
    mInkOverlay.Renderer.Draw(bgImage, allStrokes)
End Using
' now display the bitmap (with the strokes) on the panel
Using g As Graphics = Me.panelForDraw.CreateGraphics()
    g.DrawImage(bgImage, 0, 0)
End Using
bgImage.Dispose()

// get the Bitmap object loaded from a file
// scale the image to match the panel size
Bitmap bgImage = new Bitmap(new Bitmap(imageFileName), this.panelForDraw.Size);

// place (draw) the stroke collection on the bitmap
// 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)
{
    mInkOverlay.Renderer.Draw(bgImage, allStrokes);
}
// now display the bitmap (with the strokes) on the panel
using (Graphics g = this.panelForDraw.CreateGraphics())
{
    g.DrawImage(bgImage,0,0);
}

bgImage.Dispose();

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.