15.14. curses.panel — curses 的面板集扩展

面板是具有深度Function的窗口，因此它们可以堆叠在一起，并且仅显示每个窗口的可见部分。可以添加面板，在堆栈中上下移动和移除面板。

15.14.1. Functions

curses.panel模块定义以下Function：

• curses.panel. bottom_panel ( )

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

• curses.panel. new_panel(* win *)

  • 返回一个面板对象，将其与给定的窗口* win *关联。请注意，您需要保留返回的面板对象的显式引用。如果不这样做，则将对面板对象进行垃圾收集并将其从面板堆栈中移除。

• curses.panel. top_panel ( )

  • 返回面板集中的顶部面板。

• curses.panel. update_panels ( )

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

15.14.2. 面板对象

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

面板对象具有以下方法：

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

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