ol/interaction/Extent~Extent
import Extent from 'ol/interaction/Extent.js';
Позволяет пользователю рисовать прямоугольник, нажимая и перетаскивая на карте. После рисования прямоугольник можно изменить, перетаскивая его вершины или стороны. Эта интеракция поддерживается только для устройств с мышью.
-
new Extent(options)
-
Имя Тип Описание conditionCondition | undefined Функция, принимающая
MapBrowserEventи возвращающая булево значение, указывающее, нужно ли обрабатывать событие. По умолчанию —always.extentExtent | undefined Начальный extent. По умолчанию extent отсутствует.
boxStyleStyleLike | undefined Стиль для рисуемого прямоугольника. По умолчанию используется стиль редактирования
Polygon, описанный вStylepixelTolerancenumber (по умолчанию 10) Пиксельная толерантность для определения близости указателя к отрезку или вершине для редактирования.
pointerStyleStyleLike | undefined Стиль курсора, используемого для рисования extent. По умолчанию используется стиль редактирования
Point, описанный вStylewrapXboolean (по умолчанию false) Обернуть отрисованный extent через несколько карт по оси X? Воздействие только на визуализацию, не на функциональность.
Вызывает:
-
change(BaseEvent) - Общее событие изменения. Срабатывает при увеличении счетчика ревизии. -
change:active(ObjectEvent) -
error(BaseEvent) - Общее событие об ошибке. Срабатывает при возникновении ошибки. -
extentchanged(ExtentEvent) - Срабатывает после изменения extent -
propertychange(ObjectEvent) - Срабатывает при изменении свойства.
-
Расширяет
Наблюдаемые свойства
| Имя | Тип | Устанавливаемое | ObjectEvent тип | Описание |
|---|---|---|---|---|
active | boolean | да | change:active |
|
Методы
-
changed() унаследованно
-
Увеличивает счётчик ревизии и отправляет событие 'change'.
-
dispatchEvent(event){boolean | undefined} унаследованно
-
Отправляет событие и вызывает всех слушателей, прослушивающих события этого типа. Параметр event может быть строкой или объектом с свойством
type.Имя Тип Описание eventBaseEvent | string Объект события.
Возвращает:
false, если кто-то вызвал preventDefault для объекта события или если какой-либо из слушателей вернул false.
-
get(key){*} унаследованно
-
Получает значение.
Имя Тип Описание keystring Имя ключа.
Возвращает:
Значение.
-
getActive(){boolean} унаследованно
-
Возвращает, активен ли в данный момент интерактивный элемент.
Возвращает:
true, если взаимодействие активно,falseв противном случае.
-
getExtent(){Extent}
-
Возвращает текущую область, нарисованную в проекции представления (или в пользовательской проекции, если она задана).
Возвращает:
Область, нарисованную в проекции представления.
-
getExtentInternal(){Extent}
-
Возвращает текущую область, нарисованную в проекции представления.
Возвращает:
Область, нарисованную в проекции представления.
-
getKeys(){Array.<string>} унаследованно
-
Возвращает список имён свойств объекта.
Возвращает:
Список имён свойств.
-
getMap(){Map | null} унаследованно
-
Возвращает карту, связанную с этим взаимодействием.
Возвращает:
Карта.
-
getPointerCount(){number} унаследованно
-
Возвращает текущее количество указателей, участвующих во взаимодействии, например,
2, когда используются два пальца.Возвращает:
Количество указателей.
-
getProperties(){Object.<string, *>} унаследованно
-
Возвращает объект со всеми именами и значениями свойств.
Возвращает:
Объект.
-
getRevision(){number} унаследованно
-
Возвращает номер версии для этого объекта. Каждый раз, когда объект изменяется, его номер версии увеличивается.
Возвращает:
Номер ревизии.
-
on(type, listener){EventsKey | Array<EventsKey>} унаследованно
-
Подписывается на события определенного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ для слушателя. Если используется массив типов событий в качестве первого аргумента, возвращается массив ключей.
-
once(type, listener){EventsKey | Array<EventsKey>} унаследованно
-
Подписывается на событие определённого типа один раз.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ для слушателя. Если используется массив типов событий в качестве первого аргумента, возвращается массив ключей.
-
set(ключ, значение, беззвучно) унаследованный
-
Устанавливает значение.
Имя Тип Описание keyстрока Имя ключа.
value* Значение.
silentлогическое | undefined Обновить без срабатывания события.
-
setActive(активно) унаследованный
-
Активировать или деактивировать взаимодействие.
Имя Тип Описание activeлогическое Активно.
-
setExtent(область)
-
Вручную устанавливает нарисованную область, используя проекцию представления.
Имя Тип Описание extentОбласть Область
-
setProperties(значения, беззвучно) унаследованный
-
Устанавливает коллекцию пар ключ-значение. Обратите внимание, что это изменяет все существующие свойства и добавляет новые (не удаляет существующие свойства).
Имя Тип Описание valuesОбъект.<строка, *> Значения.
silentлогическое | undefined Обновить без срабатывания события.
-
un(тип, слушатель) унаследованный
-
Отключить прослушивание определенного типа события.
Имя Тип Описание typeстрока | Массив.<строка> Тип события или массив типов событий.
listenerфункция Функция-слушатель.
-
unset(ключ, беззвучно) унаследованный
-
Удаляет свойство.
Имя Тип Описание keyстрока Имя ключа.
silentлогическое | undefined Удалить без срабатывания события.
© 2005-present, OpenLayers Contributors All rights reserved.Licensed under the BSD 2-Clause License.
https://openlayers.org/en/latest/apidoc/module-ol_interaction_Extent-Extent.html