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