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

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


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

16.13.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.13.2. Объекты PanelPanel Objects

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

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