Strokes.Clip, méthode

Article
11/05/2008

Mise à jour : November 2007

Supprime les parties de tous les objets Stroke de la collection Strokes qui sont à l'extérieur d'un rectangle donné.

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

Syntaxe

'Déclaration
Public Sub Clip ( _
    r As Rectangle _
)
'Utilisation
Dim instance As Strokes
Dim r As Rectangle

instance.Clip(r)

public void Clip(
    Rectangle r
)

public:
void Clip(
    Rectangle r
)

public void Clip(
    Rectangle r
)

public function Clip(
    r : Rectangle
)

Paramètres

r
Type : System.Drawing.Rectangle

Notes

Le paramètre R est spécifié selon les coordonnées de l'espace d'entrée manuscrite.

Cette méthode met à jour l'objet Ink parent. Lorsque l'entrée manuscrite est supprimée d'un objet Ink, tous les objets Stroke ou collections Strokes définis pour cet objet Ink peuvent être invalidés.

Après avoir appelé la méthode Clip, les propriétés de chaque objet Stroke peuvent être modifiées. Par exemple, si un objet Stroke commence dans la zone du rectangle de découpage, en sort, puis y retourne, il se transforme en deux objets Stroke, dont au moins un a une nouvelle propriété Id. En dépit de ce comportement, toutes les propriétés Id sont uniques dans un objet Ink, même si elles sont modifiées. D'autres propriétés pour l'objet Stroke peuvent également subir des modifications similaires.

Exemples

Dans cet exemple, la moitié de droite de la collection Strokes d'un objet InkOverlay est découpée de la collection Strokes. En premier lieu, le rectangle englobant de la collection Strokes est obtenu en appelant la méthode GetBoundingBox. Puis un nouveau rectangle, dont la moitié de droite est découpée, est créé et passé à la méthode Clip.

' Access to the 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
    ' Determine the bounding box for the Strokes collection.
    Dim bounds As Rectangle = allStrokes.GetBoundingBox()
    'Create rectangle for Clip method.
    Dim halfRectangle As Rectangle = _
            New Rectangle(bounds.Left, bounds.Top, bounds.Width / 2, bounds.Height)
    ' Clip the Strokes collection.
    allStrokes.Clip(halfRectangle)
End Using

// Access to the 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)
{
    // Determine the bounding box for the Strokes collection.
    Rectangle bounds = allStrokes.GetBoundingBox();
    //Create rectangle for Clip method.
    Rectangle halfRectangle = 
        new Rectangle(bounds.Left, bounds.Top, bounds.Width / 2, bounds.Height);
    // Clip the Strokes collection.
    allStrokes.Clip(halfRectangle);
}

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.