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


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

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

Синтаксис

HRESULT GetRectangleIntersections(
  [in]          IInkRectangle *Rectangle,
  [out, retval] VARIANT       *Intersections
);

Параметры

[in] Rectangle

Прямоугольник в пространстве рукописного ввода , описывающий область проверки попадания.

[out, retval] Intersections

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

Дополнительные сведения о структуре VARIANT см. в разделе Использование библиотеки COM.

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

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

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

Комментарии

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

Если штрих начинается в прямоугольнике теста, первый индекс устанавливается в значение -1. Если штрих заканчивается в прямоугольнике теста, последний индекс устанавливается в значение -1. Если штрих находится исключительно за пределами прямоугольника теста, возвращается пустой массив. Например, если штрих начинается внутри тестового прямоугольника, покидает границы прямоугольника, возвращается внутрь и снова выходит, метод GetRectangleIntersections может вернуть {-1, 1.4, 5.5, 10.1} для описания двух сегментов штриха, попадающих в прямоугольник.

Требования

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

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

Метод Clip

Метод FindIntersections

Интерфейс IInkStrokeDisp