# `curses.panel` — A panel stack extension for 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.