Compartir a través de


Ink.GetBoundingBox (Método) (BoundingBoxMode)

Actualización: noviembre 2007

Devuelve el rectángulo delimitador Rectangle que contiene todos los objetos Stroke del objeto Ink, usando el marcador BoundingBoxMode especificado para determinar los límites.

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

Sintaxis

'Declaración
Public Function GetBoundingBox ( _
    mode As BoundingBoxMode _
) As Rectangle
'Uso
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

Parámetros

  • mode
    Tipo: Microsoft.Ink.BoundingBoxMode
    Un miembro de la enumeración BoundingBoxMode, que especifica qué características de un trazo, por ejemplo los atributos de dibujo, se usan para calcular el cuadro de límite de la entrada manuscrita.

Valor devuelto

Tipo: System.Drawing.Rectangle
El objeto Rectangle que define el cuadro de límite de la colección Strokes en el objeto Ink.

Comentarios

El rectángulo delimitador Rectangle se encuentra en coordenadas de espacio de entrada manuscrita.

El cuadro de límite se almacena en la memoria caché para todos los modos que no sean el modo BoundingBoxMode.

Cuando el cuadro de límite se ve afectado por el ancho de la pluma, este ancho se escala convenientemente conforme a la transformación de la 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.

Nota

Si no ha definido explícitamente el ancho de la pluma, se establecerá en 53 de forma predeterminada. Debe multiplicar el ancho de la pluma por la raíz cuadrada del determinante para obtener el cuadro de límite correcto. El alto y el ancho del cuadro de límite se amplían la mitad de esta cantidad en cada dirección. Por ejemplo, supongamos que el ancho de la pluma es 53, la raíz cuadrada del factor determinante 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).

Nota

El rectángulo delimitador Rectangle que devuelve este método es una copia del rectángulo delimitador de la colección Strokes del objeto Ink. Modificar el objeto Rectangle que devuelve este método no tiene ningún efecto en el cuadro de límite del objeto Ink original.

Nota

En Windows Vista y en versiones posteriores, el método GetBoundingBox no tiene en cuenta el ancho del trazo.

Ejemplos

En este ejemplo de C# se devuelve el rectángulo delimitador Rectangle que contiene la colección Strokes en un objeto Ink. El objeto Ink está asociado con un objeto InkCollector, theInkCollector. En el ejemplo se usa el valor CurveFit de la enumeración BoundingBoxMode para determinar los límites del cuadro de límite.

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

En este ejemplo de Microsoft Visual Basic.NET se devuelve el rectángulo delimitador Rectangle que contiene la colección Strokes en un objeto Ink. El objeto Ink está asociado con un objeto InkCollector, theInkCollector. En el ejemplo se usa el valor BoundingBoxMode de la enumeración BoundingBoxMode para determinar los límites.

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

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.

Información de versión

.NET Framework

Compatible con: 3.0

Vea también

Referencia

Ink (Clase)

Ink (Miembros)

GetBoundingBox (Sobrecarga)

Microsoft.Ink (Espacio de nombres)

Strokes

BoundingBoxMode