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

Статья
08/24/2023

Извлекает коллекцию 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