curses.panel — Uma extensão de pilha de painéis para o curses


Painéis são janelas com o recurso adicional de profundidade, então eles podem ser empilhados uns sobre os outros, e somente as partes visíveis de cada janela serão exibidas. Painéis podem ser adicionados, movidos para cima ou para baixo na pilha, e removidos.

Funções

O módulo curses.panel define as seguintes funções:

curses.panel.bottom_panel()

Retorna o painel inferior da pilha de painéis.

curses.panel.new_panel(win)

Retorna um objeto painel, associando-o à janela fornecida win. Esteja ciente de que você precisa manter o objeto painel retornado referenciado explicitamente. Se não fizer isso, o objeto painel será coletado como lixo e removido da pilha de painéis.

curses.panel.top_panel()

Retorna o painel superior da pilha de painéis.

curses.panel.update_panels()

Atualiza a tela virtual após alterações na pilha de painéis. Isso não chama curses.doupdate(), então você terá que fazer isso sozinho.

Objetos painel

Objetos painel, como retornados por new_panel() acima, são janelas com uma ordem de empilhamento. Há sempre uma janela associada a um painel que determina o conteúdo, enquanto os métodos de painel são responsáveis ​​pela profundidade da janela na pilha de painéis.

Objetos painel possuem os seguintes métodos:

Panel.above()

Retorna o painel acima do painel atual.

Panel.below()

Retorna o painel abaixo do painel atual.

Panel.bottom()

Insere o painel para o fundo da pilha.

Panel.hidden()

Retorna True se o painel estiver oculto (não visível), False caso contrário.

Panel.hide()

Oculta o painel. Isso não exclui o objeto, apenas torna a janela invisível na tela.

Panel.move(y, x)

Move o painel para as coordenadas (y, x) da tela.

Panel.replace(win)

Altera a janela associada ao painel para a janela win.

Panel.set_userptr(obj)

Define o ponteiro do usuário do painel para obj. Isso é usado para associar um pedaço arbitrário de dados ao painel, e pode ser qualquer objeto Python.

Panel.show()

Exibe o painel (que pode estar oculto).

Panel.top()

Insere o painel para o topo da pilha.

Panel.userptr()

Retorna o ponteiro do usuário para o painel. Pode ser qualquer objeto Python.

Panel.window()

Retorna o objeto de janela associado ao painel.