Renderer.Measure (Método) (Stroke)

Artículo
10/28/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.

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

Sintaxis

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

Parámetros

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

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 creado por Ink.CreateStroke, utilizando una matriz de objetos Point, points. Los objetos Ink y Renderer proceden del objeto InkOverlay, theInkOverlay.

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

En este ejemplo de Microsoft® Visual Basic® .NET se obtiene el rectángulo de límite de un objeto Stroke creado por Ink.CreateStroke, utilizando una matriz de objetos Point, points. Los objetos Ink y Renderer proceden del objeto InkOverlay, theInkOverlay.

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

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.