Ink.AddStrokesAtRectangle-Methode

Gibt die bekannte Strokes-Auflistung an, die in dieses Ink-Objekt bei einem angegebenen Rechteck eingefügt werden soll.

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

Syntax

'Declaration
Public Sub AddStrokesAtRectangle ( _
    strokes As Strokes, _
    destinationRectangle As Rectangle _
)
'Usage
Dim instance As Ink
Dim strokes As Strokes
Dim destinationRectangle As Rectangle

instance.AddStrokesAtRectangle(strokes, _
    destinationRectangle)

public void AddStrokesAtRectangle(
    Strokes strokes,
    Rectangle destinationRectangle
)

public:
void AddStrokesAtRectangle(
    Strokes^ strokes, 
    Rectangle destinationRectangle
)

public void AddStrokesAtRectangle(
    Strokes strokes,
    Rectangle destinationRectangle
)

public function AddStrokesAtRectangle(
    strokes : Strokes, 
    destinationRectangle : Rectangle
)

Parameter

strokes
Typ: Microsoft.Ink.Strokes
Die Strokes-Auflistung, die dem Ink-Objekt hinzugefügt werden soll.

destinationRectangle
Typ: System.Drawing.Rectangle
Das Rechteck, in dem die Striche hinzugefügt werden, in Freihandbereichkoordinaten.

Hinweise

Ein Laufzeitfehler wird ausgelöst, wenn das Rechteck die Koordinaten {0,0,0,0} hat.

Die Strokes-Quellauflistung wird an das Ink-Objekt angefügt.

Nachdem die Striche eingefügt wurden, werden sie vom umgebenden Rechteck der Strokes-Auflistung zum Rechteck skaliert.

Diese Methode kann verwendet werden, um Striche innerhalb eines einzelnen Ink-Objekts zu kopieren. Die Quellstriche müssen nicht aus einem anderen Ink-Objekt stammen.

Beispiele

In diesem C#-Beispiel wird die AddStrokesAtRectangle-Methode verwendet, um eine Kopie der Freihandeingabe von einem InkCollector-Objekt namens panelMain in ein InkCollector-Objekt namens panelThumb zu kopieren, wobei die richtige Skalierung und das richtige Seitenverhältnis beibehalten werden. Um den Miniaturansichtsbereich aktuell zu halten, wird panelMain ein Stroke-Ereignishandler namens panelMain_Stroke hinzugefügt.

private void panelMain_Stroke(object sender, Microsoft.Ink.InkCollectorStrokeEventArgs e)
{
    // Create a bounding rectangle for panelThumb in ink space coordinates
    Point thePoint = Point.Empty;
    using (Graphics g = Graphics.FromHwnd(Handle))
    {
        thePoint = new Point(panelThumb.Width, panelThumb.Height);
        panelMain.Renderer.PixelToInkSpace(g, ref thePoint);
    }
    Rectangle theRectangle = new Rectangle(0, 0, thePoint.X, thePoint.Y);   

    // Delete the old strokes in the thumbnail, and add the new strokes.
    panelThumb.Ink.DeleteStrokes();
    // The strokes are automatically scaled to the destination rectangle
    panelThumb.Ink.AddStrokesAtRectangle(panelMain.Ink.Strokes, theRectangle);
    Refresh();
}

In diesem Microsoft Visual Basic .NET-Beispiel wird die AddStrokesAtRectangle-Methode verwendet, um eine Kopie der Freihandeingabe von einem InkCollector-Objekt namens panelMain in ein InkCollector-Objekt namens panelThumb zu kopieren, wobei die richtige Skalierung und das richtige Seitenverhältnis beibehalten werden. Um den Miniaturansichtsbereich aktuell zu halten, wird panelMain ein Stroke-Ereignishandler namens panelMain_Stroke hinzugefügt.

 Private Sub panelMain_Stroke(ByVal sender As System.Object, _
    ByVal e As Microsoft.Ink.InkCollectorStrokeEventArgs) Handles panelMain.Stroke

    'Create a bounding rectangle for panelThumb in ink space coordinates
    Dim g As Graphics = Graphics.FromHwnd(Handle)
    Dim thePoint As Point = New Point(panelThumb.Width, panelThumb.Height)
    panelMain.Renderer.PixelToInkSpace(g, thePoint)
    'Dispose of the Graphics object
    g.Dispose()
    Dim theRectangle As Rectangle = New Rectangle(0, 0, thePoint.X, thePoint.Y)

    'Delete the old strokes in the thumbnail, and add the new strokes.
    panelThumb.Ink.DeleteStrokes()
    'The strokes are automatically scaled to the destination rectangle
    panelThumb.Ink.AddStrokesAtRectangle(panelMain.Ink.Strokes, theRectangle)
    Refresh()
End Sub

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.