curses.panel.md

1> **Источник:** https://python-all.ru/3.1/library/curses.panel.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 15.12. `curses.panel` – Расширение стека панелей для curses89Панели – это окна с дополнительной возможностью глубины: их можно располагать друг над другом, и отображаются только видимые части каждого окна. Панели можно добавлять, перемещать вверх или вниз по стеку и удалять.1011## 15.12.1. Функции1213Модуль `curses.panel` определяет следующие функции:1415#### `curses.panel.bottom_panel()`1617Возвращает нижнюю панель в стеке панелей.1819#### `curses.panel.new_panel(win)`2021Возвращает объект панели, связывая его с переданным окном2223*win*2425. Следует учитывать, что возвращаемый объект панели необходимо явно сохранять в ссылке. В противном случае объект панели будет собран сборщиком мусора и удалён из стека панелей.2627#### `curses.panel.top_panel()`2829Возвращает верхнюю панель в стеке панелей.3031#### `curses.panel.update_panels()`3233Обновляет виртуальный экран после изменений в стеке панелей. Эта функция не вызывает3435[`curses.doupdate()`](https://python-all.ru/3.1/library/curses.html#curses.doupdate)3637, так что это придётся сделать самостоятельно.3839## 15.12.2. Объекты Panel4041Объекты Panel, возвращаемые функцией [`new_panel()`](https://python-all.ru/3.1/library/curses.panel.html#curses.panel.new_panel) (см. выше), являются окнами с порядком наложения. С панелью всегда связано окно, которое определяет содержимое, а методы панели отвечают за глубину окна в стеке панелей.4243Объекты панелей имеют следующие методы:4445#### `Panel.above()`4647Возвращает панель над текущей панелью.4849#### `Panel.below()`5051Возвращает панель под текущей панелью.5253#### `Panel.bottom()`5455Перемещает панель в самый низ стека.5657#### `Panel.hidden()`5859Возвращает true, если панель скрыта (не видна), и false в противном случае.6061#### `Panel.hide()`6263Скрывает панель. При этом объект не удаляется, а только делает окно на экране невидимым.6465#### `Panel.move(y, x)`6667Перемещает панель в координаты экрана6869`(y, x)`7071.7273#### `Panel.replace(win)`7475Заменяет окно, связанное с панелью, на окно7677*win*7879.8081#### `Panel.set_userptr(obj)`8283Устанавливает пользовательский указатель панели в8485*obj*8687. Это используется для связывания с панелью произвольных данных, которые могут быть любым объектом Python.8889#### `Panel.show()`9091Отображает панель (которая могла быть скрыта).9293#### `Panel.top()`9495Перемещает панель на вершину стека.9697#### `Panel.userptr()`9899Возвращает указатель пользователя для панели. Это может быть любой объект Python.100101#### `Panel.window()`102103Возвращает объект окна, связанный с панелью.104