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