Содержание страницы
16.13. curses.panel – Расширение стека панелей для curses¶curses.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. Объекты панелей¶Panel Objects
Объекты Panel, возвращаемые функцией new_panel() (см. выше), являются окнами с порядком наложения. С панелью всегда связано окно, которое определяет содержимое, а методы панели отвечают за глубину окна в стеке панелей.
Объекты панелей имеют следующие методы:
- Panel.above()¶
Возвращает панель над текущей панелью.
- Panel.below()¶
Возвращает панель под текущей панелью.
- Panel.bottom()¶
Перемещает панель в самый низ стека.
Возвращает 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()¶
Возвращает объект окна, связанный с панелью.