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

Статья
02/29/2024

Находит точки, в которых объект 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

Share via