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

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

1. Функции

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

curses.panel.bottom_panel()

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

curses.panel.new_panel(win)

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

curses.panel.top_panel()

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

curses.panel.update_panels()

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

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()

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