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