Stroke.Clip, méthode

Article
11/05/2008

Mise à jour : November 2007

Supprime les parties de l'objet Stroke situées à 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 Stroke
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
Rectangle en dehors duquel chaque objet Stroke est découpé.

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, chaque objet Stroke sélectionné d'un InkOverlay est modifié. En premier lieu, la méthode GetBoundingBox est appelée pour déterminer le rectangle englobant d'un Stroke sélectionné. Le rectangle obtenu est ensuite modifié : sa largeur est alors égale à la moitié de sa largeur d'origine. Ensuite, la méthode Clip est appelée pour découper la moitié droite du Stroke.

For Each S As Stroke In mInkOverlay.Selection
    Dim sBounds As Rectangle = S.GetBoundingBox()
    ' decrease width by half
    sBounds.Width -= sBounds.Width / 2
    ' clip the stroke
    S.Clip(sBounds)
Next

foreach (Stroke S in mInkOverlay.Selection)
{
    Rectangle sBounds = S.GetBoundingBox();
    // decrease width by half
    sBounds.Width -= sBounds.Width / 2;
    // clip the stroke
    S.Clip(sBounds);
}

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.