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

Статья
02/29/2024

Находит расположение на штрихе, ближайшее к известной точке, и возвращает расстояние, на которое находится точка от штриха. Все находится в координатах пространства рукописного ввода.

Синтаксис

HRESULT NearestPoint(
  [in]                long  X,
  [in]                long  Y,
  [in, out, optional] float *Distance,
  [out, retval]       float *Point
);

Параметры

[in] X

Позиция по оси X в пространстве рукописного ввода проверяемой точки.

[in] Y

Позиция Y в пространстве рукописного ввода проверяемой точки.

[in, out, optional] Distance

Необязательный элемент. Расстояние от точки до штриха. Этот параметр может принимать значение NULL. Значение по умолчанию — 0.

[out, retval] Point

При возврате этим методом содержит значение индекса с плавающей запятой, представляющее ближайшее расположение в росчерке.

Индекс с плавающей запятой — это значение с плавающей запятой, представляющее расположение где-то между двумя точками в росчерке. Например, если 0,0 — это первая точка в росчерке, а 1,0 — вторая точка штриха, 0,5 — на полпути между первой и второй точками. Аналогичным образом, значение индекса с плавающей запятой 37,25 представляет расположение, которое составляет 25 процентов вдоль линии между точками 37 и 38 штриха.

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

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

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

Требования

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

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

Метод GetRectangleIntersections

Метод HitTest(Point, Single)

Интерфейс IInkStrokeDisp

Метод NearestPoint [класс InkDisp]

Share via