curses.panel — Расширение стека панелей для curses

Панели — это окна с дополнительной функцией глубины, поэтому их можно размещать друг на другом, и будут отображаться только видимые части каждого окна. Панели можно добавлять, перемещать вверх или вниз в стеке и удалять.

16.13.1. Функции

Модуль curses.panel определяет следующие функции:

curses.panel.bottom_panel()

Возвращает нижнюю панель в стеке панелей.

curses.panel.new_panel(win)

Возвращает объект панели, связывая его с заданным окном win. Обратите внимание, что вам необходимо явно сохранить ссылку на возвращённый объект панели. Если вы этого не сделаете, объект панели будет удалён из стека панелей во время сбора мусора.

curses.panel.top_panel()

Возвращает верхнюю панель в стеке панелей.

curses.panel.update_panels()

Обновляет виртуальный экран после изменений в стеке панелей. Это не вызывает curses.doupdate(), поэтому вам придётся сделать это самостоятельно.

16.13.2. Объекты панелей

Объекты панелей, возвращаемые функцией new_panel() выше, являются окнами с порядком стекирования. С объектом панели всегда ассоциировано окно, определяющее содержимое, в то время как методы панели отвечают за глубину окна в стеке панелей.

Объекты панелей имеют следующие методы:

Panel.above()

Возвращает панель, расположенную выше текущей панели.

Panel.below()

Возвращает панель, расположенную ниже текущей панели.

Panel.bottom()

Перемещает панель в низ стека.

Panel.hidden()

Возвращает True если панель скрыта (невидима), False в противном случае.

Panel.hide()

Скрыть панель. Это не удаляет объект, а просто делает окно на экране невидимым.

Panel.move(y, x)

Переместить панель в координаты экрана (y, x).

Panel.replace(win)

Изменить окно, связанное с панелью, на окно win.

Panel.set_userptr(obj)

Установить указатель пользователя панели на obj. Используется для связывания произвольных данных с панелью и может быть любым объектом Python.

Panel.show()

Отобразить панель (которая, возможно, была скрыта).

Panel.top()

Переместить панель в верхнюю часть стека.

Panel.userptr()

Возвращает указатель пользователя для панели. Это может быть любой объект Python.

Panel.window()

Возвращает объект окна, связанный с панелью.