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.
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.