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