YMaps.IToolBarItem

Интерфейс элемента управления, добавляемого на тулбар.

Конструктор

Имя Описание
YMaps.IToolBarItem() Интерфейс элемента управления, добавляемого на тулбар.

Методы

Имя Описание
onAddToToolBar(toolBar, parentContainer, group) Вызывается при добавлении элемента управления на тулбар.
onRemoveFromToolBar() Вызывается при удалении элемента управления с тулбара.

Подробное описание конструктора

YMaps.IToolBarItem()

Интерфейс элемента управления, добавляемого на тулбар.

Пример:

// Создает пользовательскую кнопку тулбара в виде раскрывающегося списка городов.
// При выборе города из списка центр карты перемещается в соответствующую точку.
var MyButton = function () {
    var element = document.createElement('select'),
        toolBar;

    var option1 = document.createElement('option');
    option1.value = '37.511553,55.749288';
    option1.selected = 'selected';
    option1.innerHTML = 'Москва';
    element.appendChild(option1);

    var option2 = document.createElement('option');
    option2.value = '30.260577,59.888582';
    option2.innerHTML = 'Санкт-Петербург';
    element.appendChild(option2);

    function showSelection () {
        toolBar.getMap().setCenter(YMaps.GeoPoint.fromString(element.options[element.selectedIndex].value));
    }

    this.onAddToToolBar = function (oToolBar, parentContainer) {
        toolBar = oToolBar;
        parentContainer.appendChild(element);
        element.onchange = showSelection;
    }

    this.onRemoveFromToolBar = function () {
        element.onchange = null;
        element.parentNode.removeChild(element);
    }
}

var map = new YMaps.Map(document.getElementById('YMapsID')),
    toolbar = new YMaps.ToolBar(new MyButton());
map.setCenter(new YMaps.GeoPoint(37.632404, 55.749288), 9);
map.addControl(toolbar);

Подробное описание методов

onAddToToolBar

onAddToToolBar(toolBar, parentContainer, group)

Вызывается при добавлении элемента управления на тулбар.

Параметры:

Имя Тип Описание
toolBar YMaps.ToolBar Указатель на тулбар.
parentContainer HTMLElement Родительский элемент для элемента управления.
group YMaps.Group Группа-контейнер элементов тулбара, в которую добавлен элемент управления. Если элемент добавляется в раскрывающийся список, то параметр group будет содержать ссылку на объект YMaps.ListBox, в остальных случаях - ссылку на тулбар.

onRemoveFromToolBar

onRemoveFromToolBar()

Вызывается при удалении элемента управления с тулбара.