curses.panel — 一个针对 curses 的面板集扩展 — Python 文档

curses.panel — 一个针对curses 的面板集扩展

---

面板是具有深度特征的窗口，因此它们可以相互堆叠，并且只会显示每个窗口的可见部分。 可以在堆栈中添加、上下移动和删除面板。

功能

模块 curses.panel 定义了以下函数：

curses.panel.bottom_panel()

返回面板集中的底部面板。

curses.panel.new_panel(win)

返回一个面板对象，将其与给定的窗口 win 相关联。 请注意，您需要明确引用返回的面板对象。 如果不这样做，面板对象将被垃圾收集并从面板堆栈中删除。

curses.panel.top_panel()

返回面板集的顶部面板。

curses.panel.update_panels()

在面板集更改后更新虚拟屏幕。 这不会调用 curses.doupdate()，因此您必须自己执行此操作。

面板对象

由上面的 new_panel() 返回的面板对象是具有堆叠顺序的窗口。 总是有一个窗口与确定内容的面板相关联，而面板方法负责面板堆栈中窗口的深度。

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()

显示面板（可能已隐藏）。

Panel.top()

将面板推到堆栈的顶部。

Panel.userptr()

返回面板的用户指针。 这可能是任何 Python 对象。

Panel.window()

返回与面板关联的窗口对象。