curses.panel — Eine Panel-Stack-Erweiterung für curses

Panels sind Fenster mit der zusätzlichen Funktion der Tiefe, sodass sie übereinander gestapelt werden können und nur die sichtbaren Teile jedes Fensters angezeigt werden. Panels können hinzugefügt, in der Stapelreihenfolge nach oben oder unten verschoben und entfernt werden.

Funktionen

Das Modul curses.panel definiert die folgenden Funktionen

curses.panel.bottom_panel()

Gibt das unterste Panel im Panel-Stack zurück.

curses.panel.new_panel(win)

Gibt ein Panel-Objekt zurück, das es mit dem gegebenen Fenster win verknüpft. Beachten Sie, dass Sie das zurückgegebene Panel-Objekt explizit referenziert halten müssen. Andernfalls wird das Panel-Objekt vom Garbage Collector entfernt und aus dem Panel-Stack entfernt.

curses.panel.top_panel()

Gibt das oberste Panel im Panel-Stack zurück.

curses.panel.update_panels()

Aktualisiert den virtuellen Bildschirm nach Änderungen im Panel-Stack. Dies ruft nicht curses.doupdate() auf, sodass Sie dies selbst tun müssen.

Panel-Objekte

Panel-Objekte, wie sie von new_panel() oben zurückgegeben werden, sind Fenster mit einer Stapelreihenfolge. Es gibt immer ein Fenster, das mit einem Panel verbunden ist, das den Inhalt bestimmt, während die Panel-Methoden für die Tiefe des Fensters im Panel-Stack verantwortlich sind.

Panel-Objekte haben die folgenden Methoden

Panel.above()

Gibt das Panel über dem aktuellen Panel zurück.

Panel.below()

Gibt das Panel unter dem aktuellen Panel zurück.

Panel.bottom()

Schiebt das Panel an das untere Ende des Stacks.

Panel.hidden()

Gibt True zurück, wenn das Panel versteckt (nicht sichtbar) ist, andernfalls False.

Panel.hide()

Versteckt das Panel. Dies löscht das Objekt nicht, sondern macht das Fenster auf dem Bildschirm unsichtbar.

Panel.move(y, x)

Verschiebt das Panel an die Bildschirmkoordinaten (y, x).

Panel.replace(win)

Ändert das mit dem Panel verbundene Fenster zu win.

Panel.set_userptr(obj)

Setzt den Benutzerzeiger des Panels auf obj. Dies wird verwendet, um beliebige Daten mit dem Panel zu verknüpfen und kann jedes Python-Objekt sein.

Panel.show()

Zeigt das Panel an (das möglicherweise versteckt war).

Panel.top()

Schiebt das Panel an die Spitze des Stacks.

Panel.userptr()

Gibt den Benutzerzeiger für das Panel zurück. Dies kann jedes Python-Objekt sein.

Panel.window()

Gibt das mit dem Panel verbundene Fensterobjekt zurück.