Renderer.Measure, méthode (Stroke, DrawingAttributes)

Article
11/05/2008

Mise à jour : November 2007

Calcule le Rectangle (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 en utilisant le DrawingAttributes spécifié.

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

Syntaxe

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

returnValue = instance.Measure(stroke, _
    da)

public Rectangle Measure(
    Stroke stroke,
    DrawingAttributes da
)

public:
Rectangle Measure(
    Stroke^ stroke, 
    DrawingAttributes^ da
)

public Rectangle Measure(
    Stroke stroke,
    DrawingAttributes da
)

public function Measure(
    stroke : Stroke, 
    da : DrawingAttributes
) : Rectangle

Paramètres

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

da
Type : Microsoft.Ink.DrawingAttributes
DrawingAttributes à utiliser lors du calcul du rectangle, qui se substitue à la propriété DrawingAttributes de l'objet Stroke.

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, theStroke, lorsque la largeur du stylet double. L'objet Renderer provient de l'objet InkOverlaytheInkOverlay.

DrawingAttributes drawingAtt = theStroke.DrawingAttributes.Clone();
drawingAtt.Width = drawingAtt.Width * 2;
Rectangle bounds = theInkOverlay.Renderer.Measure(theStroke, drawingAtt);

Cet exemple Microsoft® Visual Basic® .NET obtient le rectangle englobant pour un objet Stroke, theStroke, lorsque la largeur du stylet double. L'objet Renderer provient de l'objet InkOverlaytheInkOverlay.

Dim drawingAtt As DrawingAttributes = theStroke.DrawingAttributes.Clone();
drawingAtt.Width = drawingAtt.Width * 2;
Dim bounds As Rectangle = theInkOverlay.Renderer.Measure(theStroke, drawingAtt);

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.