TMapAtlas.GoItemDownByScale

TMapAtlas

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

                          var AtlasItem: TALSITEM): integer; overload;

function   GoItemDownByScale(scale: integer; frame: HOBJ;

                          var AtlasItem: TALSITEM): integer; overload;

Описание:

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

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

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

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

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