Strokes.GetBoundingBox, méthode

Article
11/05/2008

Mise à jour : November 2007

Retourne le Rectangle (page pouvant être en anglais) englobant qui contient l'objet Stroke, en utilisant l'indicateur BoundingBoxMode par défaut pour déterminer les limites.

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

Syntaxe

'Déclaration
Public Function GetBoundingBox As Rectangle
'Utilisation
Dim instance As Strokes
Dim returnValue As Rectangle

returnValue = instance.GetBoundingBox()

public Rectangle GetBoundingBox()

public:
Rectangle GetBoundingBox()

public Rectangle GetBoundingBox()

public function GetBoundingBox() : Rectangle

Valeur de retour

Type : System.Drawing.Rectangle
Retourne le Rectangle (page pouvant être en anglais) englobant qui définit le cadre englobant pour la collection Strokes.

Notes

Le Rectangle englobant (page pouvant être en anglais) est inclus dans les coordonnées de l'espace d'entrée manuscrite.

Le Rectangle (page pouvant être en anglais) englobant correspond à la partie de l'affichage à invalider ou redessiner lors de l'affichage d'une collection Strokes.

Lorsque la largeur du stylet affecte le cadre englobant, elle est mise à l'échelle pour la transformation d'affichage de l'objet Renderer. Pour ce faire, la largeur du stylet est multipliée par la racine carrée du déterminant de la transformation d'affichage.

Remarque :
Si vous n'avez pas explicitement défini la largeur du stylet, sa valeur par défaut est 53. Vous devez multiplier la largeur du stylet par la racine carrée du déterminant pour obtenir le cadre englobant approprié. La hauteur et la largeur du cadre englobant sont augmentées de la moitié de cette valeur dans chaque direction. Par exemple, si la largeur du stylet est 53, la racine carrée du déterminant est 50 et le cadre englobant est (0, 0, 1000, 1000). Le réglage de la largeur du stylet au cadre englobant dans chaque direction est calculé de la façon suivante : (53 * 50) / 2 . Le côté droit et le bas sont incrémentés d'une unité. Un cadre englobant rendu de (-1325, -1325, 2326, 2326) est créé.

Si vous n'avez pas explicitement défini la largeur du stylet, sa valeur par défaut est 53. Vous devez multiplier la largeur du stylet par la racine carrée du déterminant pour obtenir le cadre englobant approprié. La hauteur et la largeur du cadre englobant sont augmentées de la moitié de cette valeur dans chaque direction. Par exemple, si la largeur du stylet est 53, la racine carrée du déterminant est 50 et le cadre englobant est (0, 0, 1000, 1000). Le réglage de la largeur du stylet au cadre englobant dans chaque direction est calculé de la façon suivante : (53 * 50) / 2 . Le côté droit et le bas sont incrémentés d'une unité. Un cadre englobant rendu de (-1325, -1325, 2326, 2326) est créé.

Remarque :
Le Rectangle (page pouvant être en anglais) englobant que cette méthode retourne est une copie du cadre englobant de la collection Strokes. La modification du Rectangle (page pouvant être en anglais) que cette méthode retourne n'a aucun effet sur le cadre englobant de la collection Strokes d'origine.

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.