TMappl.GetNearestPointOfObject
Модуль: Mappl
Класс: TMappl
Найти ближайшую точку объекта слоя
Объявление
function GetNearestPointOfObject(lCode,oIndex: integer; x,y,Delta: double;
var nSubObject,LastPointNumber: integer;
var aResultX,aResultY,aDistance: double;
aCheckVertexMode: TCheckVertexMode = cvmVertexSnap): integer;
Параметры
- lCode
- код слоя
- oIndex
- уникальный индекс объекта
x
- координата исходной точки по горизонтали
y
- координата исходной точки по вертикали
Delta
- погрешность поиска, если < 0, то берется погрешность поиска для слоя (по умолчанию -1)
nSubObject
- номер подобъекта (возвращаемый параметр)
LastPointNumber
- номер начальной узловой точки отрезка, на котором найдена ближайшая точка на полилинии (возвращаемый параметр)
aResultX
- координата ближайшей точки на полилинии по горизонтали (возвращаемый параметр)
aResultY
- координата ближайшей точки на полилинии по вертикали (возвращаемый параметр)
aDistance
- расстояние до ближайшей точки на полилинии (возвращаемый параметр)
aCheckVertexMode
- вариант поиска узловых точек, по умолчанию cvmVertexSnap
Возвращает
- -2
- объект слоя не найден или у него нет графического образа
- -1
- ближайшая точка на полилинии не найдена
- 0
- ближайшая точка на полилинии найдена и совпадает с узловой точкой
- 1
- ближайшая точка на полилинии найдена и находится на отрезке между узловыми точками
Описание
Искомая точка может как совпадать с одной из узловых точек, так и находиться на отрезке между узловыми точками (номер начальной точки отрезка - LastPointNumber)
Смотри также
- GetNearestPointOfObject
- Найти ближайшую точку объекта слоя
- GetNearestPointOfLayer
- Найти ближайшую точку среди всех объектов слоя