Ink.GetBoundingBox, méthode

Article
11/05/2008

Mise à jour : November 2007

Retourne le Rectangle (page pouvant être en anglais) englobant qui contient tous les objets Stroke de l'objet Ink.

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

Syntaxe

'Déclaration
Public Function GetBoundingBox As Rectangle
'Utilisation
Dim instance As Ink
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) qui définit le cadre englobant de la collection Strokes dans l'objet Ink.

Notes

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

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 affecté de valeur à la largeur du stylet, la largeur 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. Prenez un exemple où la largeur du stylet est 53, la racine carrée du déterminant est 50 et le cadre englobant est égal à (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 affecté de valeur à la largeur du stylet, la largeur 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. Prenez un exemple où la largeur du stylet est 53, la racine carrée du déterminant est 50 et le cadre englobant est égal à (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 de l'objet Ink. La modification du Rectangle (page pouvant être en anglais) que cette méthode retourne n'a aucun effet sur le cadre englobant de l'objet Ink d'origine.

Remarque :
Dans Windows Vista et les versions ultérieures, la méthode GetBoundingBox ne prend pas la largeur du trait en considération.

Dans Windows Vista et les versions ultérieures, la méthode GetBoundingBox ne prend pas la largeur du trait en considération.

Exemples

Cet exemple C# retourne le Rectangle (page pouvant être en anglais) englobant qui contient la collection Strokes dans un objet Ink. L'objet Ink est associé à un objet InkCollector, theInkCollector.

Rectangle theBoundingBox = theInkCollector.Ink.GetBoundingBox();

Cet exemple Microsoft Visual Basic.NET retourne le Rectangle (page pouvant être en anglais) englobant qui contient la collection Strokes dans un objet Ink. L'objet Ink est associé à un objet InkCollector, theInkCollector.

Dim theBoundingBox As Rectangle = _
    theInkCollector.Ink.GetBoundingBox()

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.