Документация Python неофициальный перевод
Содержание страницы

16.14. curses.panel – расширение стека панелей для cursescurses.panel – A panel stack extension for curses

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

16.14.1. ФункцииFunctions

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

curses.panel.bottom_panel()

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

curses.panel.new_panel(win)

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

curses.panel.top_panel()

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

curses.panel.update_panels()

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

16.14.2. Объекты панелиPanel Objects

Объекты 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()

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