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

Метод IInkDisp::HitTestCircle (msinkaut.h)

  • Статья

Извлекает коллекцию InkStrokes , которая полностью внутри или пересекается известным кругом.

Синтаксис

HRESULT HitTestCircle(
  [in]          long        X,
  [in]          long        Y,
  [in]          float       radius,
  [out, retval] IInkStrokes **Strokes
);

Параметры

[in] X

Положение по оси X центра круга проверки попадания в единицах пространства рукописного ввода.

[in] Y

Положение по оси Y центра круга проверки попадания в единицах пространства рукописного ввода.

[in] radius

Радиус круга, используемого в тесте на попадание, в единицах пространства рукописного ввода.

[out, retval] Strokes

При возврате этого метода содержит коллекцию штрихов, которые либо полностью внутри, либо пересекаются заданным кругом.

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

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

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

Комментарии

Если штрих пересекается с кругом, возвращается полный росчерк.

Метод вычисляет пересечение, учитывая полный набор атрибутов рисования, которые применяются к росчерку, включая полную ширину пера, сглаживание Безье (при наличии) и форму кончика пера.

После того как преобразование поворота или сдвига было выполнено для росчерка или коллекции штрихов, преобразованные x- координаты и больше y- не концентрические с исходными координатами. По этой radius причине аргумент не должен вычисляться по координатам x- или y- .

Чтобы определить, какие точки известного штриха пересекаются с тестовой областью, вызовите метод HitTest объекта IInkStrokeDisp .

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

Требования

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

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

Метод HitTest(Point[], Single)

Метод HitTest(Rectangle, Single)

IInkDisp

Класс InkDisp

Коллекция InkStrokes