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

Извлекает штрихи, содержащиеся в указанном прямоугольнике.

Синтаксис

HRESULT HitTestWithRectangle(
  [in]          IInkRectangle *SelectionRectangle,
  [in]          float         IntersectPercent,
  [out, retval] IInkStrokes   **Strokes
);

Параметры

[in] SelectionRectangle

Прямоугольник выделения типа InkRectangle в координатах пространства рукописного ввода.

[in] IntersectPercent

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

[out, retval] Strokes

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

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

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

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

Комментарии

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

Требования

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

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

Метод HitTest(Point, Single)

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

IInkDisp

Класс InkDisp

Коллекция InkStrokes