Renderer.Measure, méthode (Stroke)

Article
11/05/2008

Mise à jour : November 2007

Calcule leRectangle (page pouvant être en anglais) sur le contexte de périphérique nécessaire pour contenir l'objet Stroke à dessiner avec la méthode Draw de l'objet Renderer.

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

Syntaxe

'Déclaration
Public Function Measure ( _
    stroke As Stroke _
) As Rectangle
'Utilisation
Dim instance As Renderer
Dim stroke As Stroke
Dim returnValue As Rectangle

returnValue = instance.Measure(stroke)

public Rectangle Measure(
    Stroke stroke
)

public:
Rectangle Measure(
    Stroke^ stroke
)

public Rectangle Measure(
    Stroke stroke
)

public function Measure(
    stroke : Stroke
) : Rectangle

Paramètres

stroke
Type : Microsoft.Ink.Stroke
Objet Stroke à mesurer.

Valeur de retour

Type : System.Drawing.Rectangle
Rectangle (page pouvant être en anglais) sur le contexte de périphérique nécessaire pour contenir les traits s'ils ont été dessinés avec la méthode Draw de l'objet Renderer. Le trait doit contenir des coordonnées x et y pour calculer le rectangle. Sinon, la méthode retourne un rectangle vide.

Notes

Cette méthode est exacte uniquement si vous passez les mêmes arguments aux méthodes Measure et Draw.

Étant donné que le cadre englobant est défini par la largeur du stylet, cette largeur est mise à l'échelle de façon appropriée 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. La hauteur et la largeur du cadre englobant sont augmentées de la moitié de cette valeur dans chaque direction. Le côté droit et le bas sont incrémentés d'une unité.

Par exemple, si la largeur du stylet est initialement 53, la racine carrée du déterminant de la transformation d'affichage 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éé.

Exemples

Cet exemple C# obtient le rectangle englobant pour un objet Stroke créé par le Ink.CreateStroke, en utilisant un tableau d'objets Pointpoints (page pouvant être en anglais). Les objets Ink et Renderer proviennent de l'objet InkOverlaytheInkOverlay.

Stroke createdStroke = theInkOverlay.Ink.CreateStroke(points);
Rectangle bounds = theInkOverlay.Renderer.Measure(createdStroke);

Cet exemple Microsoft® Visual Basic® .NET obtient le rectangle englobant pour un objet Stroke créé par le Ink.CreateStroke, en utilisant un tableau d'objets Point (page pouvant être en anglais), points. Les objets Ink et Renderer proviennent de l'objet InkOverlaytheInkOverlay.

Dim createdStroke As Stroke = theInkOverlay.Ink.CreateStroke(points)
Dim bounds As Rectangle = theInkOverlay.Renderer.Measure(createdStroke)

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.