TMapView.SetMapHandle

TMapView

Установить в компонент уже открытую карту по ее идентификатору.

function SetMapHandle(value : HMAP): HMAP;

Описание:

Метод устанавливает в компонент уже открытую карту.

Карта в компонент устанавливается по ее идентификатору (HMAP), получаемому при ее открытии функциями ГИС-ядра (например, mapOpenData). После установки идентификатора карты, компонент будет работать с ней как со "своей", то есть так же, как если бы эта карта была открыта самим компонентом (установкой свойства MapFileName или вызовом методов MapOpen или MapOpenPro).

Это означает, что карта предоставленная компоненту извне с помощью данного метода будет закрыта во всех случаях, когда компонент выполняет закрытие карты, отрытой им самим. Чтобы этого не происходило, необходимо своевременно "отвязать" компонент от идентификатора карты (HMAP) путем

вызова того же метода SetMapHandle с нулевым идентификатором (SetMapHandle(0)).

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