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

Статья
08/24/2023

Извлекает штрихи в области выбора ломаной линии.

Синтаксис

HRESULT HitTestWithLasso(
  [in]                VARIANT     Points,
  [in]                float       IntersectPercent,
  [in, out, optional] VARIANT     *LassoPoints,
  [out, retval]       IInkStrokes **Strokes
);

Параметры

[in] Points

Точки, используемые в инструменте выделения для выбора штрихов. Область выделения — это область внутри границы выделения, в которой граница сначала пересекается. Если граница не пересекается, метод добавляет точку в конец массива, чтобы создать прямую линию от первой до последней точки. Если граница является прямой (нет области в пределах границы выделения), штрихи не выбираются.

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

[in] IntersectPercent

Процент точек росчерка, которые должны содержаться в инструменте выделения, чтобы включить штрих в результирующий набор штрихов. Если значение равно нулю (0), все штрихи, содержащиеся в средстве выделения или пересекаемые с ним, включаются в результирующий набор штрихов. При значении 100 в коллекцию включаются только росчерки, полностью содержащиеся в средстве выбора. Штрихи, пересекающиеся с инструментом выделения, включаются в коллекцию, если процент точек в этих штрихах, содержащихся в инструменте выделения, больше или равен проценту percentIntersect . Дробные проценты округляются вверх.

[in, out, optional] LassoPoints

Необязательный элемент. Извлекает определенную часть средства выделения, которая используется для выделения. Так как пользователь может рисовать множество различных типов инструментов выделения, некоторые из которых перекрываются несколько раз, это может быть полезно для иллюстрации того, какая часть средства выделения использовалась для выбора. Значением по умолчанию является указатель NULL , что означает, что никакие сведения не возвращаются.

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

[out, retval] Strokes

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

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

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

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

Требования

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

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

Метод HitTest(Point, Single)

Метод HitTest(Rectangle, Single)

IInkDisp

Класс InkDisp

Коллекция InkStrokes

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