multiRouter.Editor

Расширяет ICustomizable , IEventEmitter .

Редактор мультимаршрута.

Конструктор | Поля | События | Методы

Конструктор

multiRouter.Editor(multiRoute[, state[, options]])

Создает редактор мультимаршрута.

Параметры:

Параметр Значение по умолчанию Описание
multiRoute *

Тип: multiRouter.MultiRoute

Редактируемый мультимаршрут.

state

Тип: Object

Объект, описывающий начальное состояние редактора. Список доступных полей смотрите в описании multiRouter.Editor.state .

options

Тип: Object

Опции.

options.drawCursor

Тип: Object

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

options.drawOver true

Тип: Object

Разрешает ставить точки поверх объектов карты в режиме добавления новых путевых точек.

options.midPointsType "way"

Тип: String

Определяет тип добавляемых точек при перетаскивании маркера, появляющегося при наведении курсора мыши на активный маршрут. Может принимать одно из следующих строковых значений:
  • "way" – добавлять путевые точки;
  • "via" – добавлять транзитные точки.
Также смотрите описание поля addMidPoints менеджера состояния multiRouter.Editor.state .

* Обязательный параметр/опция.

Поля

Имя Тип Описание
events IEventManager

Менеджер событий.

Унаследовано от IEventEmitter .

options IOptionManager

Менеджер опций.

Унаследовано от ICustomizable .

state data.Manager

Менеджер состояния редактора мультимаршрута.

Доступные поля:

  • addWayPoints: Boolean - разрешает добавление новых путевых точек при клике на карту. Значение по умолчанию: false.
  • dragWayPoints: Boolean - разрешает перетаскивание уже существующих путевых точек. Значение по умолчанию: true.
  • removeWayPoints: Boolean – разрешает удаление путевых точек по двойному клику по ним. Значение по умолчанию: false.
  • dragViaPoints: Boolean - разрешает перетаскивание уже существующих транзитных точек. Значение по умолчанию: true.
  • removeViaPoints: Boolean – разрешает удаление путевых точек по двойному клику по ним. Значение по умолчанию: true.
  • addMidPoints: Boolean - разрешает добавление промежуточных транзитных или путевых точек посредством перетаскивания маркера, появляющегося при наведении курсора мыши на активный маршрут. Тип добавляемых точек задается опцией midPointsType. Значение по умолчанию: true.

События

Имя Описание
beforemidpointadd
Событие, предшествующее событию midpointadd. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • coords: Number[] - координаты добавления промежуточной точки;
  • pointType: String – идентификатор типа добавляемой промежуточной точки;
  • insertIndex: Integer – индекс вставки промежуточной точки во множестве опорных точек мультимаршрута.
Имена методов, доступных через метод Event.callMethod :
  • setPointType - метод, позволяющий задать тип добавляемой точки. В качестве аргумента принимает строковый идентификатор типа (смотрите описание опции midPointsType).
  • setInsertIndex - метод, позволяющий скорректировать индекс вставки промежуточной точки, который будет фактически применен. В качестве аргумента принимает новый индекс.
Если у данного события вызвать метод Event.preventDefault , то последующее добавление промежуточной точки маршрута, как и событие "midpointadd", будет отменено.
beforemidpointdrag
Событие, предшествующее событию midpointdrag. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;
Имена методов, доступных через метод Event.callMethod :
  • setPixelOffset - метод, позволяющий скорректировать значение пиксельного сдвига, который будет фактически применен. В качестве аргумента принимает новый пиксельный сдвиг в виде массива из двух чисел.
Если у данного события вызвать метод Event.preventDefault , то последующее событие "midpointdrag" будет отменено.
beforemidpointpinshow
Событие, предшествующее событию midpointpinshow. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pin: Placemark - ссылка на объект маркера;
  • globalPixels: Number[] - глобальные пиксельные координаты маркера;
  • segment: multiRouter.driving.Segment – ссылка на сегмент маршрута, над которым появился маркер.
Если у данного события вызвать метод Event.preventDefault , то последующее событие "midpointpinshow" будет отменено, а маркер будет скрыт.
beforeviapointdrag
Событие, предшествующее событию viapointdrag. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;
  • viaPoint: multiRouter.ViaPoint – ссылка на объект перетаскиваемой транзитной точки.
Имена методов, доступных через метод Event.callMethod :
  • setPixelOffset - метод, позволяющий скорректировать значение пиксельного сдвига, который будет фактически применен. В качестве аргумента принимает новый пиксельный сдвиг в виде массива из двух чисел.
Если у данного события вызвать метод Event.preventDefault , то последующее событие "viapointdrag" будет отменено.
beforeviapointdragstart
Событие, предшествующее событию viapointdragstart. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • domEvent: DomEvent – исходное DOM-событие, если оно имеется;
  • viaPoint: multiRouter.ViaPoint – ссылка на объект перетаскиваемой транзитной точки.
Если у данного события вызвать метод Event.preventDefault , то последующее перетаскивание, как и событие "viapointdragstart", будет отменено.
beforeviapointremove
Событие, предшествующее событию viapointremove. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • viaPoint: multiRouter.ViaPoint - ссылка на объект удаляемой транзитной точки.
Если у данного события вызвать метод Event.preventDefault , то удаление транзитной точки, как и последующее событие "viapointremove", будет отменено.
beforewaypointadd
Событие, предшествующее событию waypointadd. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • coords: Number[] - координаты добавленной путевой точки.
Имена методов, доступных через метод Event.callMethod :
  • setCoords - метод, позволяющий скорректировать координаты добавляемой путевой точки. В качестве аргумента принимает новые координаты в виде массива из двух чисел.
Если у данного события вызвать метод Event.preventDefault , то добавление путевой точки, как и последующее событие "waypointadd", будет отменено.
beforewaypointdrag
Событие, предшествующее событию waypointdrag. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;
  • wayPoint: multiRouter.WayPoint – ссылка на объект перетаскиваемой путевой точки.
Имена методов, доступных через метод Event.callMethod :
  • setPixelOffset - метод, позволяющий скорректировать значение пиксельного сдвига, который будет фактически применен. В качестве аргумента принимает новый пиксельный сдвиг в виде массива из двух чисел.
Если у данного события вызвать метод Event.preventDefault , то последующее событие "waypointdrag" будет отменено.
beforewaypointdragstart
Событие, предшествующее событию waypointdragstart. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • domEvent: DomEvent – исходное DOM-событие, если оно имеется;
  • wayPoint: multiRouter.WayPoint – ссылка на объект перетаскиваемой путевой точки.
Если у данного события вызвать метод Event.preventDefault , то последующее перетаскивание, как и событие "waypointdragstart", будет отменено.
beforewaypointremove
Событие, предшествующее событию waypointremove. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • wayPoint: multiRouter.WayPoint - ссылка на объект удаляемой путевой точки.
Если у данного события вызвать метод Event.preventDefault , то удаление путевой точки, как и последующее событие "waypointremove", будет отменено.
midpointadd
Добавление промежуточной точки маршрута. Тип точки определяется значением опции midPointsType. Экземпляр класса Event. Имена полей, доступных через метод Event.get :
  • coords: Number[] - координаты добавления промежуточной точки;
  • pointType: String – идентификатор типа добавляемой промежуточной точки;
  • insertIndex: Integer – индекс вставки промежуточной точки во множестве опорных точек мультимаршрута.
midpointdrag
Перетаскивание добавленной промежуточной точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;
midpointdragend

Завершение перетаскивания добавленной промежуточной точки. Экземпляр класса Event .

midpointpinshow
Появление перетаскиваемого маркера при наведении на активный маршрут. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pin: Placemark - ссылка на объект маркера;
  • globalPixels: Number[] - глобальные пиксельные координаты маркера;
  • segment: multiRouter.driving.Segment – ссылка на сегмент маршрута, над которым появился маркер.
optionschange

Изменение в опциях объекта.

Унаследовано от ICustomizable .

viapointdrag
Перетаскивание транзитной точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;
  • viaPoint: multiRouter.ViaPoint – ссылка на объект перетаскиваемой транзитной точки.
viapointdragend
Завершение перетаскивания транзитной точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • viaPoint: multiRouter.ViaPoint – ссылка на объект перетаскиваемой транзитной точки.
viapointdragstart
Начало перетаскивания транзитной точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • domEvent: DomEvent – исходное DOM-событие, если оно имеется;
  • viaPoint: multiRouter.ViaPoint – ссылка на объект перетаскиваемой транзитной точки.
viapointremove
Удаление транзитной точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • viaPoint: multiRouter.ViaPoint - ссылка на объект удаленной транзитной точки.
waypointadd
Добавление путевой точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • coords: Number[] - координаты добавленной путевой точки.
waypointdrag
Перетаскивание путевой точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;
  • wayPoint: multiRouter.WayPoint – ссылка на объект перетаскиваемой путевой точки.
waypointdragend
Завершение перетаскивания путевой точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • wayPoint: multiRouter.WayPoint – ссылка на объект перетаскиваемой путевой точки.
waypointdragstart
Начало перетаскивания путевой точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • domEvent: DomEvent – исходное DOM-событие, если оно имеется;
  • wayPoint: multiRouter.WayPoint – ссылка на объект перетаскиваемой путевой точки.
waypointremove
Удаление путевой точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • wayPoint: multiRouter.WayPoint - ссылка на объект удаленной путевой точки.

Методы

Имя Возвращает Описание
destroy ()

Уничтожает редактор мультимаршрута.

getMultiRoute ()

multiRouter.MultiRoute

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

Описание полей

state

{data.Manager} state

Менеджер состояния редактора мультимаршрута.

Доступные поля:

  • addWayPoints: Boolean - разрешает добавление новых путевых точек при клике на карту. Значение по умолчанию: false.
  • dragWayPoints: Boolean - разрешает перетаскивание уже существующих путевых точек. Значение по умолчанию: true.
  • removeWayPoints: Boolean – разрешает удаление путевых точек по двойному клику по ним. Значение по умолчанию: false.
  • dragViaPoints: Boolean - разрешает перетаскивание уже существующих транзитных точек. Значение по умолчанию: true.
  • removeViaPoints: Boolean – разрешает удаление путевых точек по двойному клику по ним. Значение по умолчанию: true.
  • addMidPoints: Boolean - разрешает добавление промежуточных транзитных или путевых точек посредством перетаскивания маркера, появляющегося при наведении курсора мыши на активный маршрут. Тип добавляемых точек задается опцией midPointsType. Значение по умолчанию: true.

Описание событий

beforemidpointadd

Событие, предшествующее событию midpointadd. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • coords: Number[] - координаты добавления промежуточной точки;
  • pointType: String – идентификатор типа добавляемой промежуточной точки;
  • insertIndex: Integer – индекс вставки промежуточной точки во множестве опорных точек мультимаршрута.
Имена методов, доступных через метод Event.callMethod :
  • setPointType - метод, позволяющий задать тип добавляемой точки. В качестве аргумента принимает строковый идентификатор типа (смотрите описание опции midPointsType).
  • setInsertIndex - метод, позволяющий скорректировать индекс вставки промежуточной точки, который будет фактически применен. В качестве аргумента принимает новый индекс.
Если у данного события вызвать метод Event.preventDefault , то последующее добавление промежуточной точки маршрута, как и событие "midpointadd", будет отменено.

beforemidpointdrag

Событие, предшествующее событию midpointdrag. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;
Имена методов, доступных через метод Event.callMethod :
  • setPixelOffset - метод, позволяющий скорректировать значение пиксельного сдвига, который будет фактически применен. В качестве аргумента принимает новый пиксельный сдвиг в виде массива из двух чисел.
Если у данного события вызвать метод Event.preventDefault , то последующее событие "midpointdrag" будет отменено.

beforemidpointpinshow

Событие, предшествующее событию midpointpinshow. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pin: Placemark - ссылка на объект маркера;
  • globalPixels: Number[] - глобальные пиксельные координаты маркера;
  • segment: multiRouter.driving.Segment – ссылка на сегмент маршрута, над которым появился маркер.
Если у данного события вызвать метод Event.preventDefault , то последующее событие "midpointpinshow" будет отменено, а маркер будет скрыт.

beforeviapointdrag

Событие, предшествующее событию viapointdrag. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;
  • viaPoint: multiRouter.ViaPoint – ссылка на объект перетаскиваемой транзитной точки.
Имена методов, доступных через метод Event.callMethod :
  • setPixelOffset - метод, позволяющий скорректировать значение пиксельного сдвига, который будет фактически применен. В качестве аргумента принимает новый пиксельный сдвиг в виде массива из двух чисел.
Если у данного события вызвать метод Event.preventDefault , то последующее событие "viapointdrag" будет отменено.

beforeviapointdragstart

Событие, предшествующее событию viapointdragstart. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • domEvent: DomEvent – исходное DOM-событие, если оно имеется;
  • viaPoint: multiRouter.ViaPoint – ссылка на объект перетаскиваемой транзитной точки.
Если у данного события вызвать метод Event.preventDefault , то последующее перетаскивание, как и событие "viapointdragstart", будет отменено.

beforeviapointremove

Событие, предшествующее событию viapointremove. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • viaPoint: multiRouter.ViaPoint - ссылка на объект удаляемой транзитной точки.
Если у данного события вызвать метод Event.preventDefault , то удаление транзитной точки, как и последующее событие "viapointremove", будет отменено.

beforewaypointadd

Событие, предшествующее событию waypointadd. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • coords: Number[] - координаты добавленной путевой точки.
Имена методов, доступных через метод Event.callMethod :
  • setCoords - метод, позволяющий скорректировать координаты добавляемой путевой точки. В качестве аргумента принимает новые координаты в виде массива из двух чисел.
Если у данного события вызвать метод Event.preventDefault , то добавление путевой точки, как и последующее событие "waypointadd", будет отменено.

beforewaypointdrag

Событие, предшествующее событию waypointdrag. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;
  • wayPoint: multiRouter.WayPoint – ссылка на объект перетаскиваемой путевой точки.
Имена методов, доступных через метод Event.callMethod :
  • setPixelOffset - метод, позволяющий скорректировать значение пиксельного сдвига, который будет фактически применен. В качестве аргумента принимает новый пиксельный сдвиг в виде массива из двух чисел.
Если у данного события вызвать метод Event.preventDefault , то последующее событие "waypointdrag" будет отменено.

beforewaypointdragstart

Событие, предшествующее событию waypointdragstart. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • domEvent: DomEvent – исходное DOM-событие, если оно имеется;
  • wayPoint: multiRouter.WayPoint – ссылка на объект перетаскиваемой путевой точки.
Если у данного события вызвать метод Event.preventDefault , то последующее перетаскивание, как и событие "waypointdragstart", будет отменено.

beforewaypointremove

Событие, предшествующее событию waypointremove. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • wayPoint: multiRouter.WayPoint - ссылка на объект удаляемой путевой точки.
Если у данного события вызвать метод Event.preventDefault , то удаление путевой точки, как и последующее событие "waypointremove", будет отменено.

midpointadd

Добавление промежуточной точки маршрута. Тип точки определяется значением опции midPointsType. Экземпляр класса Event. Имена полей, доступных через метод Event.get :
  • coords: Number[] - координаты добавления промежуточной точки;
  • pointType: String – идентификатор типа добавляемой промежуточной точки;
  • insertIndex: Integer – индекс вставки промежуточной точки во множестве опорных точек мультимаршрута.

midpointdrag

Перетаскивание добавленной промежуточной точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;

midpointdragend

Завершение перетаскивания добавленной промежуточной точки. Экземпляр класса Event .

midpointpinshow

Появление перетаскиваемого маркера при наведении на активный маршрут. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pin: Placemark - ссылка на объект маркера;
  • globalPixels: Number[] - глобальные пиксельные координаты маркера;
  • segment: multiRouter.driving.Segment – ссылка на сегмент маршрута, над которым появился маркер.

viapointdrag

Перетаскивание транзитной точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;
  • viaPoint: multiRouter.ViaPoint – ссылка на объект перетаскиваемой транзитной точки.

viapointdragend

Завершение перетаскивания транзитной точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • viaPoint: multiRouter.ViaPoint – ссылка на объект перетаскиваемой транзитной точки.

viapointdragstart

Начало перетаскивания транзитной точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • domEvent: DomEvent – исходное DOM-событие, если оно имеется;
  • viaPoint: multiRouter.ViaPoint – ссылка на объект перетаскиваемой транзитной точки.

viapointremove

Удаление транзитной точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • viaPoint: multiRouter.ViaPoint - ссылка на объект удаленной транзитной точки.

waypointadd

Добавление путевой точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • coords: Number[] - координаты добавленной путевой точки.

waypointdrag

Перетаскивание путевой точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • pixelOffset: Number[] - пиксельный сдвиг по осям на данном шаге;
  • wayPoint: multiRouter.WayPoint – ссылка на объект перетаскиваемой путевой точки.

waypointdragend

Завершение перетаскивания путевой точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • wayPoint: multiRouter.WayPoint – ссылка на объект перетаскиваемой путевой точки.

waypointdragstart

Начало перетаскивания путевой точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • domEvent: DomEvent – исходное DOM-событие, если оно имеется;
  • wayPoint: multiRouter.WayPoint – ссылка на объект перетаскиваемой путевой точки.

waypointremove

Удаление путевой точки. Экземпляр класса Event . Имена полей, доступных через метод Event.get :
  • wayPoint: multiRouter.WayPoint - ссылка на объект удаленной путевой точки.

Описание методов

destroy

{} destroy()

Уничтожает редактор мультимаршрута.

getMultiRoute

{multiRouter.MultiRoute} getMultiRoute()

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