TMapAtlas.AtlasFileName

TMapAtlas

Имя файла атласа.

property AtlasFileName: string

Описание:

Свойство устанавливает и возвращает имя файла атласа. По сути, атлас представляет собой пользовательскую карту, объектами которой являются границы (рамки) карт – элементов данного атласа. Файл атласа имеет расширение .als.

При указании в свойстве пустой строки, атлас, на который настроен компонент TMapAtlas, закрывается и свойство AtlasHandle устанавливается в ноль.

При указании в свойстве имени файла существующего атласа производится попытка его открытия (вызов метода OpenAtlas) и, в случае удачи, компонент TMapAtlas настраивается на указанный атлас.

Если в свойстве указывается несуществующий файл атласа, или файл не являющийся атласом, свойство устанавливается в пустую строку, уже открытый атлас закрывается, свойство AtlasHandle устанавливается в ноль.

Внимание! Вызовы методов OpenAtlas и CreateAtlas, где в качестве параметра указывается имя открываемого или создаваемого файла атласа соответственно, в случае удачного выполнения перенастраивают компонент на этот атлас и, как следствие, меняется значение свойства AtlasFileName.

Таким образом, свойство всегда содержит имя файла реально открытого атласа, на который настроен компонент TMapAtlas.