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

  • Artículo

Recupera el rectángulo delimitador 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 de trazo que se van a usar para calcular el rectángulo de selección. El valor predeterminado es -1, lo que indica que se usan todas las características de un trazo para especificar el rectángulo de selección.

Para obtener más información sobre el uso de características de trazo para calcular un rectángulo de selección, vea el tipo de enumeración BoundingBoxMode .

[out, retval] Rectangle

Cuando este método devuelve, contiene un puntero al 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 rectángulo 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
 Tipo de propiedad o parámetro inesperado.
REGDB_CLASSNOTREG
 El objeto InkRectangle no está registrado.

Comentarios

Cuando el rectángulo 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 delimitador 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 rectángulo 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 rectángulo delimitador representado de (-1325, -1325, 2326, 2326).
 

Requisitos

Requisito Value
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

IInkStrokeDisp (Interfaz)

InkBoundingBoxMode (enumeración)

Clase InkRectangle