Создание кнопок

Создание кнопки

Расположение кнопки в интерфейсе ГИС Аксиома определяется Вкладкой и Группой. Например, вкладка “Основные” группа “Команды”. В модуле axipy.menubar есть необходимые функции для создания кнопок.

from axipy import ActionButton, Position, tr

button = ActionButton("Простое действие", on_click=lambda: print("triggered"))
position = Position(tr("Основные"), tr("Команды"))
position.add(button)

Детально разберем, что делает этот пример.

Создается кнопка с текстом “Простое действие”, и ,используя параметр on_click, привязывается нажатие на кнопку к анонимной лямбде, которая печатает в консоль текст «triggered». Это обработчик нажатия кнопки. Обработчиком может служить любой callable-объект(функтор) без параметров, т.е. функции, лямбды, объекты с методом __call__. Также можно задать иконку кнопки параметром icon=. Иконкой может быть строка-ссылка на ресурс или объект типа PySide2.QtGui.QIcon.

Далее ищется расположение в интерфейсе. Если вкладка или группа с такими именами отсутствуют, то они будут созданы при добавлении кнопки.

В последней строке кнопка добавляется в заданное расположение.

Доступность кнопки

В приложении ГИС Аксиома многие кнопки и инструменты меняют свойство доступности в зависимости от текущего состояния. Например, если кнопка производит действие над выбранным объектом, то логично сделать эту кнопку доступной только при наличии выбранных объектов. Чтобы проще задавать подобное поведение для своих кнопок, предлагается использовать axipy.Observer и место их создания и получения axipy.ObserverManager.

Так, чтобы сделать кнопку активной только при наличии выборки, ее можно создать следующим образом, передав параметр enable_on функции axipy.menubar.create_button():

from axipy import menubar, ObserverManager

button = menubar.create_button(
    "Имя кнопки",
    on_click=lambda: print("on_click"),
    enable_on=ObserverManager.Selection
)

Идентификаторы наблюдателей по умолчанию перечислены в axipy.ObserverManager.

Для инструментов идентификатор рекомендуется задавать в самом классе инструмента, переопределив параметр axipy.MapTool.enable_on.

Возможно добавление своих наблюдателей, в том числе их комбинация с уже существующими axipy.ObserverManager.create().

Чтобы получить текущее значение наблюдателя, используется свойство axipy.Observer.value.