TMapView.AppendDataPro

TMapView

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

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

Описание:

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

aFileName - имя добавляемого файла (SIT; ; SITX; MTW; MTQ; RSW; MPT).

Возвращает идентификатор типа данных:

- FILE_MAPSIT - для пользовательской карты;

- FILE_SITX - для пользовательской карты формата SITX с возможностью шифрования

- FILE_RSW - для растра;

- FILE_MTW - для матрицы;

- FILE_MTL - для матрицы слоев;

- FILE_MTQ - для матрицы качеств;

- FILE_WMS - для подключения к WMS-сервису.

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

Параметр 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-битный код для шифрования данных (при утрате данные не восстанавливаются).

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

При успешном добавлении генерируются соответствующие события – OnAppendSite, OnAppendRst, OnAppendMtr, OnAppendMtq или OnAppendWMS (в зависимости от того, какие именно данные были добавлены).