Поделиться через

Метод IInkStrokeDisp::GetBoundingBox (msinkaut.h)

  • Статья

Извлекает ограничивающий прямоугольник в координатах пространства рукописного ввода для всех штрихов в объекте InkDisp , отдельном росчерке или коллекции InkStrokes .

Синтаксис

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

Параметры

[in, optional] BoundingBoxMode

Необязательный параметр. Задает характеристики штриха, используемые для вычисления ограничивающего прямоугольника. Значение по умолчанию — -1, указывающее, что для указания ограничивающего прямоугольника используются все характеристики штриха.

Дополнительные сведения об использовании характеристик штриха для вычисления ограничивающего прямоугольника см. в разделе Тип перечисления BoundingBoxMode .

[out, retval] Rectangle

При возврате этим методом содержит указатель на прямоугольник, определяющий ограничивающий прямоугольник объекта InkDisp , объекта IInkStrokeDisp или коллекции InkStrokes .

Примечание Для объекта IInkStrokeDisp возвращенный ограничивающий прямоугольник является копией ограничивающего прямоугольника штрихов, поэтому изменение возвращаемого ограничивающего прямоугольника не влияет на расположение штрихов.
 

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Успешно.
E_POINTER
 Параметр содержит недопустимый указатель.
E_INK_EXCEPTION
 В методе произошло исключение.
E_UNEXPECTED
 Непредвиденный параметр или тип свойства.
REGDB_CLASSNOTREG
 Объект InkRectangle не зарегистрирован.

Комментарии

Если ширина пера влияет на ограничивающий прямоугольник, эта ширина масштабируется соответствующим образом для преобразования представления InkRenderer. Для этого ширина пера умножается на квадратный корень определяющего элемента преобразования представления.

Примечание В Windows Vista и более поздних версиях метод GetBoundingBox не учитывает ширину штриха.
 
Примечание Если ширина пера не задана явным образом, по умолчанию она равна 53. Чтобы получить правильный ограничивающий прямоугольник, необходимо умножить ширину пера на квадратный корень детерминанта. Высота и ширина ограничивающего прямоугольника расширяются на половину этого значения в каждом направлении. Например, рассмотрим, что ширина пера составляет 53, квадратный корень детерминанта — 50, а ограничивающий прямоугольник — (0, 0, 1000, 1000). Корректировка ширины пера для ограничивающего прямоугольника в каждом направлении вычисляется как (53 * 50) / 2, а правая и нижняя стороны увеличиваются на единицу. В результате отображается ограничивающий прямоугольник (-1325, -1325, 2326, 2326).
 

Требования

Требование Значение
Минимальная версия клиента Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header msinkaut.h
Библиотека InkObj.dll

См. также раздел

Интерфейс IInkStrokeDisp

Перечисление InkBoundingBoxMode

Класс InkRectangle