Ink.GetBoundingBox, méthode (BoundingBoxMode)

Article
11/05/2008

Mise à jour : November 2007

Retourne le Rectangle (page pouvant être en anglais) englobant qui contient tous les objets Stroke dans l'objet Ink, en utilisant l'indicateur BoundingBoxMode spécifié pour définir les limites.

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

Syntaxe

'Déclaration
Public Function GetBoundingBox ( _
    mode As BoundingBoxMode _
) As Rectangle
'Utilisation
Dim instance As Ink
Dim mode As BoundingBoxMode
Dim returnValue As Rectangle

returnValue = instance.GetBoundingBox(mode)

public Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public:
Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public function GetBoundingBox(
    mode : BoundingBoxMode
) : Rectangle

Paramètres

mode
Type : Microsoft.Ink.BoundingBoxMode
Membre de l'énumération BoundingBoxMode, qui spécifie quelles caractéristiques d'un trait, telles que les attributs de dessin, sont utilisées pour calculer le cadre englobant de l'entrée manuscrite.

Valeur de retour

Type : System.Drawing.Rectangle
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.

Le cadre englobant est mis en cache pour tous les modes autres que BoundingBoxMode.

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.

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. L'exemple utilise la valeur CurveFit de l'énumération BoundingBoxMode pour déterminer les limites du cadre englobant.

Rectangle theBoundingBox =
    theInkCollector.Ink.GetBoundingBox(BoundingBoxMode.CurveFit);

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. L'exemple utilise la valeur BoundingBoxMode de l'énumération BoundingBoxMode pour définir les limites.

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

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.