Renderer.Measure (Método) (Stroke, DrawingAttributes)

Artículo
11/26/2008

Actualización: noviembre 2007

Calcula el Rectangle en el contexto de dispositivo necesario para incluir el objeto Stroke que se va a dibujar con el método Draw del objeto Renderer utilizando el objeto DrawingAttributesespecificado.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Function Measure ( _
    stroke As Stroke, _
    da As DrawingAttributes _
) As Rectangle
'Uso
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

Parámetros

stroke
Tipo: Microsoft.Ink.Stroke
Objeto Stroke que se va a medir.

da
Tipo: Microsoft.Ink.DrawingAttributes
El objeto DrawingAttributes que se va a utilizar al calcular el rectángulo, que invalida la propiedad DrawingAttributes del objeto Stroke.

Valor devuelto

Tipo: System.Drawing.Rectangle
El Rectangle en el contexto de dispositivo necesario para incluir el objeto que se va a dibujar con el método Draw del objeto Renderer. El trazo debe contener coordenadas x y coordenadas y para calcular el rectángulo. En caso contrario, el método devuelve un rectángulo vacío.

Comentarios

Este método sólo es preciso si se pasan los mismos argumentos a los métodos Draw y Measure.

Como el cuadro de límite se ve afectado por el ancho de la pluma, la escala de este ancho se ajusta de acuerdo a la transformación de vista del objeto Renderer. Para ello, el ancho de la pluma se multiplica por la raíz cuadrada del determinante de la transformación de vista. El alto y ancho del cuadro de límite se expanden la mitad de esta cantidad en cada dirección, y el lado derecho e inferior se incrementan en uno.

Por ejemplo, supongamos que el ancho de la pluma originalmente es 53, la raíz cuadrada del determinante de la transformación de vista es 50 y el cuadro de límite es (0, 0, 1000, 1000). El ajuste del ancho de la pluma respecto al cuadro de límite en cada dirección se calcula con esta operación (53 * 50) / 2, y la parte derecha e inferior se incrementan en uno. Esto genera un cuadro de límite representado de (-1325, -1325, 2326, 2326).

Ejemplos

En este ejemplo de C# se obtiene el rectángulo de límite de un objeto Stroke, theStroke, cuando se duplica el ancho de la pluma. El objeto Renderer procede del objeto InkOverlay, theInkOverlay.

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

En este ejemplo de Microsoft® Visual Basic® .NET se obtiene el rectángulo de límite de un objeto Stroke, theStroke, cuando se duplica el ancho de la pluma. El objeto Renderer procede del objeto InkOverlay, theInkOverlay.

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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.