behavior.RouteEditor
Расширяет IBehavior.
Поведение "редактор маршрутов".
Конструктор | Поля | События | Методы
Конструктор
behavior.RouteEditor()
Поля
Имя |
Тип |
Описание |
Менеджер событий. Унаследовано от IEventEmitter. |
||
Менеджер опций. Унаследовано от ICustomizable. |
События
Имя |
Описание |
Выключение поведения. Унаследовано от IBehavior. |
|
Включение поведения. Унаследовано от IBehavior. |
|
Изменение в опциях объекта. Унаследовано от ICustomizable. |
|
Сменился родительский объект. Поля данных:
Унаследовано от IChild. |
|
Событие смены маршрута вследствие вызова метода setState или включения/выключения поведения. Старый и новый маршрут можно получить через свойства события 'oldRoute' и 'newRoute' соответственно. |
Методы
Имя |
Возвращает |
Описание |
disable() |
Выключает поведение. Унаследован от IBehavior. |
|
enable() |
Включает поведение. Унаследован от IBehavior. |
|
IParentOnMap|null |
Возвращает ссылку на родительский объект или null, если родительский элемент не был установлен. Унаследован от IChildOnMap. |
|
getRoute() |
Возвращает маршрут. |
|
getState() |
String |
Возвращает текущее состояние редактора маршрутов в закодированном виде. |
Boolean |
Проверяет, включено ли поведение. Унаследован от IBehavior. |
|
Устанавливает родительский объект. Если передать значение null, то элемент управления будет только удален из текущего родительского объекта. Унаследован от IChildOnMap. |
||
Восстанавливает состояние редактора маршрутов из закодированной строки. При установлении нового маршрута будет вызвано событие routechange. |
Описание событий
routechange
Событие смены маршрута вследствие вызова метода setState или включения/выключения поведения. Старый и новый маршрут можно получить через свойства события 'oldRoute' и 'newRoute' соответственно.
Описание методов
getRoute
{router.Route} getRoute()
Возвращает маршрут.
getState
{String} getState()
Возвращает текущее состояние редактора маршрутов в закодированном виде.
setState
{} setState(state)
Восстанавливает состояние редактора маршрутов из закодированной строки. При установлении нового маршрута будет вызвано событие routechange.
Параметры:
Параметр |
Значение по умолчанию |
Описание |
— |
Тип: String|null Закодированное состояние редактора маршрутов. Состояние задается в следующем формате: rt=точка1~точка2~точка3~точка4...&via=индексы-via-points Например, если закодированная строка выглядит так: "rt=50,30~42,35~45,32~40,30&via=1,2", это значит что путевыми точками маршрута должны быть "50,30" и "40,30", а промежуточными "42,35" и "45,32". Если параметр via не указывать, то маршрут будет состоять только из путевых точек. |
* Обязательный параметр/опция.
Пример:
var behavior = map.behaviors.get('routeEditor');
behavior.events.add('routechange', function (e) {
var newRoute = e.get('newRoute');
alert(newRoute.getLength()); // Длина нового маршрута.
setTimeout(function () {
// Удаляем маршрут.
behavior.setState(null);
})
});
behavior.setState('rt=55.874872,37.562677~55.92517867214157,37.62725433916199~55.920011490602526,37.6629269628905&via=1');
Обязательный параметр.