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

curses.panel – расширение для работы со стеком панелей в cursescurses.panel – A panel stack extension for curses


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

ФункцииFunctions

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

exception curses.panel.error

Исключение, возникающее при возврате ошибки функцией библиотеки панелей curses.

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

curses.panel.bottom_panel()

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

curses.panel.new_panel(win)

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

curses.panel.top_panel()

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

curses.panel.update_panels()

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

Объекты панелейPanel objects

class curses.panel.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()

Отображает панель (которая могла быть скрыта), помещая её на вершину\nстека панелей.

panel.top()

Перемещает панель на вершину стека.

panel.userptr()

Возвращает указатель пользователя для панели. Это может быть любой объект Python.

panel.window()

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