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

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

Функции

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

exception curses.panel.error: Исключение, возникающее, когда функция библиотеки панелей curses возвращает ошибку.

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

curses.panel.bottom_panel(): Возвращает нижнюю панель в стеке панелей.

curses.panel.new_panel(win): Возвращает объект панели, связывая его с заданным окном win и помещая новую панель наверх стека панелей. Не забывайте явно сохранять ссылку на возвращённый объект панели. Если этого не сделать, объект панели будет удалён сборщиком мусора и удалён из стека панелей.

curses.panel.top_panel(): Возвращает верхнюю панель в стеке панелей.

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

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

class curses.panel.panel

Объекты панелей, возвращаемые описанной выше функцией 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(): Возвращает объект окна, связанный с панелью.