Compartir a través de

Método IInkDisp::GetBoundingBox (msinkaut.h)

  • Artículo

Recupera el cuadro de límite en coordenadas de espacio de entrada de lápiz para todos los trazos de un objeto InkDisp , un trazo individual o una colección InkStrokes .

Sintaxis

HRESULT GetBoundingBox(
  [in, optional] InkBoundingBoxMode BoundingBoxMode,
  [out, retval]  IInkRectangle      **Rectangle
);

Parámetros

[in, optional] BoundingBoxMode

Opcional. Especifica las características del trazo que se van a usar para calcular el cuadro de límite. Para obtener más información sobre el uso de características de trazo para calcular un cuadro de límite, vea el tipo de enumeración BoundingBoxMode .

El valor predeterminado es -1 (IBBM_DEFAULT), lo que significa que todas las características de un trazo se usan para especificar el cuadro de límite.

[out, retval] Rectangle

Cuando este método devuelve , contiene el rectángulo que define el rectángulo delimitador de un objeto InkDisp , un objeto IInkStrokeDisp o una colección InkStrokes .

Nota Para un objeto IInkStrokeDisp , el cuadro de límite devuelto es una copia del rectángulo delimitador de trazos, por lo que modificar el rectángulo de límite devuelto no afecta a la ubicación de los trazos.
 

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
E_POINTER
 Un parámetro contenía un puntero no válido.
E_INK_EXCEPTION
 Se produjo una excepción dentro del método .
E_UNEXPECTED
 Parámetro o tipo de propiedad inesperados.
REGDB_CLASSNOTREG
 El objeto InkRectangle no está registrado.

Comentarios

Cuando el cuadro de límite se ve afectado por el ancho del lápiz, este ancho se escala adecuadamente para la transformación de vista de InkRenderer . Para ello, el ancho del lápiz se multiplica por la raíz cuadrada del determinante de la transformación de vista.

Nota En Windows Vista y versiones posteriores, el método GetBoundingBox no tiene en cuenta el ancho del trazo.
 
Nota Si no ha establecido explícitamente el ancho del lápiz, es 53 de forma predeterminada. Debe multiplicar el ancho del lápiz por la raíz cuadrada del determinante para producir el rectángulo de límite correcto. El alto y el ancho del rectángulo delimitador se expanden por la mitad de esta cantidad en cada dirección. Por ejemplo, considere que el ancho del lápiz es 53, la raíz cuadrada del determinante es 50 y el cuadro de límite es (0, 0, 1000, 1000). El ajuste del ancho del lápiz en el rectángulo delimitador en cada dirección se calcula como (53 * 50) / 2, y los lados derecho e inferior se incrementan en uno. Esto da como resultado un cuadro de límite representado de (-1325, -1325, 2326, 2326).
 

Requisitos

   
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado msinkaut.h
Library InkObj.dll

Consulte también

IInkDisp

InkBoundingBoxMode (enumeración)

InkDisp (clase)

InkRectangle (clase)