Метод IInkStrokeDisp::NearestPoint (msinkaut.h)
Находит расположение на штрихе, ближайшее к известной точке, и возвращает расстояние, на которое находится точка от штриха. Все находится в координатах пространства рукописного ввода.
Синтаксис
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 штриха.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Успешно. |
|
Параметр содержит недопустимый указатель. |
|
Произошла неизвестная ошибка. |
|
В методе произошло исключение. |
Комментарии
Параметр distance описывает расстояние от точки до конверта штриха. Это расстояние между двумя точками минус половина ширины штриха.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | msinkaut.h |
| Библиотека | InkObj.dll |