TMapSites.Append

TMapSites

Добавить карту обстановки.

function Append(ASiteFileName: string): integer;

function Append(ASiteFileName: string; mode : integer): integer;

function Append(ASiteFileName: string; mode : integer; transform : integer): integer;

Описание:

Производится попытка совместного открытия карты обстановки и в случае успеха возвращает порядковый номер в списке.

В случае неудачи функция возвращает 0.

Параметр ASiteFileName задает полный путь к файлу карты обстановки.

Параметр mode устанавливает режим доступа к файлу данных: чтение/запись (GENERIC_WRITE или 0) или только чтение (GENERIC_READ). Если параметр mode равен GENERIC_READ, то данные открываются только на чтение; при этом не открываются файлы \Log\name.log и \Log\name.tac - протокол работы и журнал транзакций.

Если параметр mode не указан, то данные открываются для чтения/записи.

Параметр transform устанавливает режим трансформирования добавляемых данных к ранее открытым данным (если проекции разные):

0 - не трансформировать данные (преобразовывать "на лету"),

1 - трансформировать данные при открытии и сохранить карту в новой проекции,

-1 - задать вопрос пользователю.

Если параметр transform не указан, то задается вопрос пользователю.

Для закрытой карты никаких действий не производится.