TMapAtlas.GoItemUpByScale

TMapAtlas

function   GoItemUpByScale(scale: integer; var GeoPoint: TDOUBLEPOINT;

                          var AtlasItem: TALSITEM): integer; overload;

function   GoItemUpByScale(scale: integer; frame: HOBJ;

                          var AtlasItem: TALSITEM): integer; overload;

Описание:

Найти элемент расположенный в заданной точке – GeoPoint, либо внутри заданной области (рамки) – frame, мельче указанного масштаба.

Координаты точки GeoPoint задаются в геодезической системе координат.

Область задается метрикой объекта, дескриптор которого передается в параметре frame. Указанный объект должен существовать и иметь более двух точек метрики.

При наличии требуемого элемента, структура AtlasItem заполняется соответствующими данными, в противном случае и при ошибке метод возвращает ноль.

Этот метод можно использовать для нахождения самой крупномасштабной карты (с минимальным значением знаменателя масштаба). Для этого требуется в методе указать значение знаменателя масштаба минимально возможное, например – 1, тогда в результате вызова метода будет подобрана первая карта из атласа, имеющая наименьший знаменатель масштаба, максимально близкий к указанному значению. То есть будет найдена самая крупномасштабная карта.