Ink.AddStrokesAtRectangle, méthode

Article
11/05/2008

Mise à jour : November 2007

Spécifie la collection Strokes connue à insérer dans cet objet Ink dans un rectangle spécifié.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Sub AddStrokesAtRectangle ( _
    strokes As Strokes, _
    destinationRectangle As Rectangle _
)
'Utilisation
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
)

Paramètres

strokes
Type : Microsoft.Ink.Strokes
Collection Strokes à ajouter à l'objet Ink.

destinationRectangle
Type : System.Drawing.Rectangle
Rectangle où les traits sont ajoutés, selon les coordonnées de l'espace d'entrée manuscrite.

Notes

Une erreur d'exécution se produit si les coordonnées du rectangle sont {0,0,0,0}.

La collection Strokes source est ajoutée à l'objet Ink.

Lorsqu'ils sont insérés, les traits à l'échelle du cadre englobant de la collection Strokes sont mis à l'échelle du rectangle.

Cette méthode peut être utilisée pour copier des traits dans un objet Ink unique. Il n'est pas nécessaire que les traits source proviennent d'un autre objet Ink.

Exemples

Cet exemple C# utilise la méthode AddStrokesAtRectangle pour copier l'entrée manuscrite d'un objet InkCollector principal, panelMain, sur un objet InkCollector, panelThumb, en conservant l'échelle et les proportions appropriées. Pour conserver le panneau miniature actif, un gestionnaire d'événements Stroke, panelMain_Stroke, est ajouté à panelMain.

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();
}

Cet exemple Microsoft Visual Basic.NET utilise la méthode AddStrokesAtRectangle pour copier l'entrée manuscrite d'un objet InkCollector principal, panelMain, sur un objet InkCollector, panelThumb, en conservant l'échelle et les proportions appropriées. Pour conserver le panneau miniature actif, un gestionnaire d'événements Stroke, panelMain_Stroke, est ajouté à panelMain.

 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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.