Rectangle
Расширяет GeoObject.
Прямоугольник. Представляет собой геообъект с геометрией geometry.Rectangle.
См.: GeoObjectgeometry.Rectangle
Конструктор | Поля | События | Методы
Конструктор
Rectangle(geometry[, properties[, options]])
Создает экземпляр прямоугольника.
Параметры:
Параметр |
Значение по умолчанию |
Описание |
— |
Тип: Number[][]|Object|IRectangleGeometry Координаты двух противоположных углов, хэш-объект с параметрами геометрии или ссылка на объект геометрии прямоугольника. |
|
— |
Тип: Object|IDataManager Данные прямоугольника. Могут задаваться как экземпляр класса, реализующего интерфейс IDataManager, либо в виде хэша. При значениях опций по умолчанию геообъектом трактуются следующие поля данных:
|
|
— |
Тип: Object Опции прямоугольника. Используя этот параметр можно задавать как опции самого прямоугольника, так и опции его составных частей:
|
|
"pointer" |
Тип: String Вид курсора над прямоугольником. |
|
false |
Тип: Boolean Определяет возможность перетаскивания прямоугольника. |
|
true |
Тип: Boolean Наличие заливки фигуры. |
|
"0066ff99" |
Тип: String Цвет заливки. |
|
— |
Тип: String Фоновое изображение. При включении данной опции в режиме заливки stretch значение опции fillColor игнорируется. |
|
'stretch' |
Тип: String Тип заливки фоном. Может принимать одно из двух значений:
|
|
1 |
Тип: Number Прозрачность заливки. |
|
true |
Тип: Boolean Определяет наличие поля balloon у прямоугольника. |
|
true |
Тип: Boolean Определяет наличие поля hint у прямоугольника. |
|
false |
Тип: Boolean Включает режим автоматического изменения z-index прямоугольника в зависимости от его состояния. |
|
"default#geoObject" |
Тип: String Модель интерактивности. Доступные ключи и их значения перечислены в описании interactivityModel.storage. |
|
1 |
Тип: Number Прозрачность. |
|
true |
Тип: Boolean Определяет, показывать ли балун при щелчке на прямоугольнике. |
|
false |
Тип: Boolean Определяет, показывать ли пустой балун при щелчке на прямоугольнике. |
|
false |
Тип: Boolean Определяет, показывать ли хинт при наведении указателя мыши на прямоугольник. |
|
true |
Тип: Boolean Определяет, показывать ли хинт при наведении указателя мыши на прямоугольник. |
|
true |
Тип: Boolean Наличие обводки фигуры. |
|
"places" |
Тип: String Ключ пейна, в который помещается оверлей прямоугольника. |
|
"default#rectangle" |
Тип: String|Function Ключ-идентификатор из хранилища overlay.storage или класс оверлея. Функция-генератор принимает три параметра:
|
|
"0066ffff" |
Тип: String|String[] Цвет линии или обводки. Можно задать несколько значений для множественной обводки. |
|
1 |
Тип: Number|Number[] Прозрачность линии или обводки. Можно задать несколько значений для множественной обводки. |
|
— |
Тип: String|Object|String[]|Object[] Стиль линии или обводки. Доступные стили перечислены в объекте graphics.style.stroke. |
|
1 |
Тип: Number|Number[] Толщина линии или обводки. Можно задать несколько значений для множественной обводки. |
|
false |
Тип: Boolean Включает синхронное добавление оверлея на карту. По умолчанию добавление оверлея осуществляется асинхронно, что позволяет предотвратить зависания браузера при добавлении на карту большого числа геообъектов. Однако, асинхронное добавление не позволяет получать доступ к оверлею сразу после добавления прямоугольника на карту. |
|
true |
Тип: Boolean При перетаскивании объекта к краю карты происходит автоматическое изменение центра карты. Нужно ли учитывать отступы карты при автоматическом смещении центра карты map.margin.Manager. |
|
true |
Тип: Boolean Определяет видимость прямоугольника. |
|
— |
Тип: Number z-index прямоугольника в обычном состоянии. Наименее приоритетный. |
|
— |
Тип: Number z-index прямоугольника с открытым балуном. Наиболее приоритетный. |
|
— |
Тип: Number z-index прямоугольника при перетаскивании. |
|
— |
Тип: Number z-index прямоугольника при наведении на него указателя мыши. |
* Обязательный параметр/опция.
Пример:
// Создание геодезической окружности радиусом 1000 километров.
var circle = new ymaps.Circle([[50, 50], 1000000], {}, {
draggable: true
});
// Добавление круга на карту.
myMap.geoObjects.add(circle);
// Создание прямоугольника на основе границ круга.
var rectangle = new ymaps.Rectangle(circle.geometry.getBounds(), {}, {
fill: false,
coordRendering: "boundsPath",
strokeWidth: 4
});
// Добавление прямоугольника на карту.
myMap.geoObjects.add(rectangle);
// Обновление координат прямоугольника при изменении геометрии окружности.
circle.geometry.events.add("change", function (event) {
this.geometry.setCoordinates(event.get("target").getBounds());
}, rectangle);
Поля
Имя |
Тип |
Описание |
Балун геообъекта. Унаследовано от GeoObject. |
||
null |
Редактор геометрии "Прямоугольник" на данный момент не реализован. |
|
Менеджер событий. Унаследовано от GeoObject. |
||
Геометрия типа "Прямоугольник". |
||
Хинт геообъекта. Унаследовано от GeoObject. |
||
Менеджер опций геообъекта. Унаследовано от GeoObject. |
||
Менеджер данных геообъекта. Унаследовано от GeoObject. |
||
Состояние геообъекта. Определяется следующими полями:
Унаследовано от GeoObject. |
События
Имя |
Описание |
Закрытие балуна. Экземпляр класса Event. Унаследовано от GeoObject. |
|
Открытие балуна на геообъекте. Экземпляр класса Event. Унаследовано от GeoObject. |
|
Событие, предшествующее событию drag. Экземпляр класса Event. Имена полей, доступных через метод Event.get:
Унаследовано от GeoObject. |
|
Событие, предшествующее событию dragstart. Экземпляр класса Event. Имена полей, доступных через метод Event.get:
Унаследовано от GeoObject. |
|
Однократное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса MapEvent. Более детальное описание доступно в domEvent.manager. Унаследовано от IDomEventEmitter. |
|
Вызов контекстного меню на элементе. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса MapEvent. Более детальное описание доступно в domEvent.manager. Унаследовано от IDomEventEmitter. |
|
Двойное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса MapEvent. Более детальное описание доступно в domEvent.manager. Унаследовано от IDomEventEmitter. |
|
Перетаскивание геообъекта. Экземпляр класса Event. Имена полей, доступных через метод Event.get:
Унаследовано от GeoObject. |
|
Завершение перетаскивания геообъекта. Экземпляр класса Event. Имена полей, доступных через метод Event.get:
Унаследовано от GeoObject. |
|
Начало перетаскивания геообъекта. Экземпляр класса Event. Имена полей, доступных через метод Event.get:
Унаследовано от GeoObject. |
|
Изменение состояния редактора геометрии геообъекта. Экземпляр класса Event. Имена полей, доступных через метод Event.get:
Унаследовано от GeoObject. |
|
Изменение геометрии геообъекта. Экземпляр класса Event. Имена полей, доступных через метод Event.get:
Унаследовано от IGeoObject. |
|
Закрытие хинта. Экземпляр класса Event. Унаследовано от GeoObject. |
|
Открытие хинта на геообъекте. Экземпляр класса Event. Унаследовано от GeoObject. |
|
Сменилась карта. Поля данных:
Унаследовано от IParentOnMap. |
|
Нажатие кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса MapEvent. Более детальное описание доступно в domEvent.manager. Унаследовано от IDomEventEmitter. |
|
Наведение курсора на объект. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса MapEvent. Более детальное описание доступно в domEvent.manager. Унаследовано от IDomEventEmitter. |
|
Вывод курсора за пределы объекта. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса MapEvent. Более детальное описание доступно в domEvent.manager. Унаследовано от IDomEventEmitter. |
|
Перемещение курсора над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса MapEvent. Более детальное описание доступно в domEvent.manager. Унаследовано от IDomEventEmitter. |
|
Отпускание кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса MapEvent. Более детальное описание доступно в domEvent.manager. Унаследовано от IDomEventEmitter. |
|
Окончание мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent. Унаследовано от IDomEventEmitter. |
|
Повторящееся событие при мультисенсорном управлении. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Определяет свойство touches, которое содержит список прикосновений. Каждое прикосновение описано объектом, которое содержит поля:
Унаследовано от IDomEventEmitter. |
|
Начало мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Определяет свойство touches, которое содержит список прикосновений. Каждое прикосновение описано объектом, которое содержит поля:
Унаследовано от IDomEventEmitter. |
|
Изменение в опциях объекта. Унаследовано от ICustomizable. |
|
Изменение оверлея геообъекта. Экземпляр класса Event. Имена полей, доступных через метод Event.get:
Унаследовано от IGeoObject. |
|
Сменился родительский объект. Поля данных:
Унаследовано от IChild. |
|
Изменение данных геообъекта. Экземпляр класса Event. Имена полей, доступных через метод Event.get:
Унаследовано от IGeoObject. |
|
Скролл мышкой. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса MapEvent. Более детальное описание доступно в domEvent.manager. Унаследовано от IDomEventEmitter. |
Методы
Имя |
Возвращает |
Описание |
getMap() |
Возвращает ссылку на карту. Унаследован от IParentOnMap. |
|
Возвращает объект-обещание, который подтверждается объектом оверлея в момент его фактического создания, либо отклоняется с передачей соответствующей ошибки. Унаследован от IGeoObject. |
||
IOverlay|null |
Метод предоставляет синхронный доступ к оверлею. Унаследован от IGeoObject. |
|
IParentOnMap|null |
Возвращает ссылку на родительский объект или null, если родительский элемент не был установлен. Унаследован от IChildOnMap. |
|
Устанавливает родительский объект. Если передать значение null, то элемент управления будет только удален из текущего родительского объекта. Унаследован от IChildOnMap. |
Описание полей
editor
{null} editor
Редактор геометрии "Прямоугольник" на данный момент не реализован.
geometry
{geometry.Rectangle} geometry
Геометрия типа "Прямоугольник".
Обязательный параметр.