Содержание страницы
curses.panel – расширение для curses для работы со стеком панелей.¶curses.panel – A panel stack extension for curses.
Панели – это окна с дополнительной возможностью глубины: их можно располагать друг над другом, и отображаются только видимые части каждого окна. Панели можно добавлять, перемещать вверх или вниз по стеку и удалять.
Функции¶Functions
Модуль curses.panel определяет следующие функции:
- curses.panel.bottom_panel()¶
- Возвращает нижнюю панель в стеке панелей.
- curses.panel.new_panel(win)¶
- Возвращает объект панели, связывая его с переданным окном win. Следует учитывать, что возвращаемый объект панели необходимо явно сохранять в ссылке. В противном случае объект панели будет собран сборщиком мусора и удалён из стека панелей.
- curses.panel.top_panel()¶
- Возвращает верхнюю панель в стеке панелей.
- curses.panel.update_panels()¶
- Обновляет виртуальный экран после изменений в стеке панелей. Эта функция не вызывает curses.doupdate(), так что это придётся сделать самостоятельно.
Объекты Panel¶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()¶
- Возвращает объект окна, связанный с панелью.