Елементи управління - це компоненти користувальницького інтерфейсу, за допомогою яких користувач може змінювати налаштування карти.
елементи управління
На даний момент доступні елементи керування:
DG.Controls.Zoom - дозволяє змінювати дозвіл карти;
DG.Controls.Abstract - клас, за допомогою якого можна створювати свої власні елементи управління.
Групи елементів керування
Кожен елемент управління повинен належати певній групі. Це дає можливість виконувати групові операції.
Наприклад, нехай у нас є два типи елементів управління: одні для переміщення по містах, інші для фіксованої установки масштабу. Розмістивши перші в одну групу, а другі - в іншу, ми можемо явно маніпулювати кожним з наборів елементів управління.
Об'єкт групи надає найбільш повний арсенал методів для управління елементами управління.
Будь-які операції з елементами управління в групі відразу ж відображаються на карті.
Менеджер елементів управління
Менеджер відповідає за управління групами. А групи, в свою чергу, управляють елементами управління.
При цьому, для зручності, частина методів по роботі з елементами управління є також і в менеджері.
Менеджер елементів управління доступний як властивість controls об'єкта карти:
клас DG.Controls.Zoom
конструктор
клас DG.Controls.FullScreen
Кнопка розгортання карти на весь екран браузера і відновлення попереднього розміру.
конструктор
клас DG.ControlPosition
Для того щоб розмістити елемент управління в потрібному місці карти, використовуємо клас DG.ControlPosition.
Для наочності припустимо, що myPosition - екземпляр класу DG.ControlPostition.
конструктор
Задає точку відліку для об'єкта DG.Point. тим самим дозволяючи визначити область розміщення елемента управління на мапі.
Допустимі значення:
DG.ControlPosition.TOP_LEFT - Верхня ліва частина кордону карти. Константа.
DG.ControlPosition.TOP_RIGHT - Верхній правий кут кордону карти. Константа.
DG.ControlPosition.BOTTOM_LEFT - Нижній лівий кут кордону карти. Константа.
DG.ControlPosition.BOTTOM_RIGHT - Нижній правий кут кордону карти. Константа.
Об'єкт DG.Point. Задає позицію елемента управління - відступи від нової точки відліку, заданої в position. Значення в пікселях.
Отримаємо елемент управління в правому верхньому кутку карти з відступами 20 і 10 пікселів від кордонів карти, по горизонталі і вертикалі відповідно.
Встановити позицію елемента управління
Функція-конструктор, за допомогою якої можна створити об'єкт елемента управління. Важливо розуміти, що будь-який клас - це функція-конструктор.
Зробимо уточнення. Припустимо, ми хочемо створити клас MyControlClass. На першому кроці створюємо об'єкт obj. який містить методи onAddToMap () і onRemoveFromMap ():
На другому кроці створюємо клас MyControlClass:
Тепер, щоб створити об'єкт класу MyControlClass. все як завжди:
При цьому метод obj.onAddToMap буде викликаний при створенні класу MyControlClass. а метод obj.onRemoveFromMap - при його видаленні.
Важлива особливість: MyControlClass містить всі члени об'єкта obj. а також всі методи DG.Controls.Abstract. які ми розглянемо в подальшому.
Зараз розглянемо комплексний, але досить складний приклад.
В результаті отримаємо елемент управління, який знаходиться в правому верхньому куті екрану і являє собою прямокутник з написом Moscow. при кліці по якій центр карти встановлюється в центр міста Москва - координати (37.609. 55.753).
Отримати контейнерний DOMElement елементи управління
Показати елемент управління
Видалити елемент управління
Клас менеджера елементів управління DG.Controls
Менеджер відповідає за управління групами. А групи, в свою чергу, управляють елементами управління.
При цьому, для зручності, частина методів по роботі з маркерами є також і в менеджері.
Нижче ми докладно розглянемо всі методи класу менеджера. Для наочності припустимо, що myMap - об'єкт карти.
Опис методів є дія (що робить метод, для чого він потрібен?) І назва методу. Разом з тим, представлені додатково параметри, повертається значення методу і особливості, якщо такі є.
Створити менеджер шарів явно через ключове слово new можна. Він автоматично доступний як властивість controls об'єкта карти.
Методи управління групами елементів управління
Створити групу
Видалити всі елементи управління
При цьому, хоч всі елементи управління і видаляються, групи залишаються незачепленими.
Клас групи елементів управління DG.ControlGroup
Об'єкт групи надає найбільш повний арсенал методів, для управління елементами управління.
Нижче ми докладно розглянемо всі методи класу групи елементів управління. Для наочності припустимо, що myGroup - об'єкт групи.
Опис методів є дія (що робить метод, для чого він потрібен?) І назва методу. Разом з тим, представлені додатково параметри, повертається значення методу і особливості, якщо такі є.
Створити групу елементів управління явно через ключове слово new можна. Правильно це робити за допомогою методу createGroup менеджера елементів управління.
Додати елемент управління в групу
Порядковий номер додається елемента управління в групі. При цьому нумерація елементів управління починається з нуля.
Якщо параметр не переданий, елемент управління буде додано в кінець групи.
Обмеження: значення має бути цілим невід'ємним числом не перевищує поточний кількість елементів управління в групі. Таким чином забезпечується безперервна нумерація елементів в групі.