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

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