TMapSites.AppendPro

TMapSites

Добавить карту обстановки с возможностью открытия зашифрованных данных

function AppendPro (const aFileName: string; mode : integer = 0; transform : integer = 0; const password: string = ''):integer;

Описание:

Добавить пользовательскую карту к открытой карте c заданным режимом, вариантом трансформирования и возможностью раскодирования данных по паролю.

aFileName - полный путь к файлу карты обстановки (SIT; SITX).

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

Данные добавляются в список последними. Если эти же данные уже были открыты, число открытых данных не меняется.

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

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

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

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

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

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

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

Если задан параметр password, производится попытка расшифровки добавляемых данных.

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

Если пароль не передан, а он был указан при создании, то автоматически вызывается диалог scnGetMapPassword из gisdlgs.dll. Если выдача сообщений запрещена (mapIsMessageEnable()), то диалог не вызывается, а при отсутствии пароля происходит отказ открытия данных.

password - пароль доступа к данным из которого формируется 256-битный код для шифрования данных (при утрате данные не восстанавливаются).

При ошибке возвращает ноль.