"curses.panel" --- Una extensión de pila de panel para curses
*************************************************************

======================================================================

Los paneles son ventanas con la característica de profundidad añadida,
por lo que se pueden apilar una encima de la otra, y solo se mostrarán
las partes visibles de cada ventana. Los paneles se pueden agregar,
mover hacia arriba o hacia abajo en la pila y eliminarse.


Funciones
=========

El módulo "curses.panel" define las siguientes funciones:

curses.panel.bottom_panel()

   Retorna el panel inferior en la pila del panel.

curses.panel.new_panel(win)

   Retorna un objeto de panel, asociándolo con la ventana dada *win*.
   Tenga en cuenta que debe mantener explícitamente el objeto de panel
   retornado al que se hace referencia. Si no lo hace, el objeto de
   panel se recoge como basura y elimina de la pila del panel.

curses.panel.top_panel()

   Retorna el panel superior de la pila de paneles.

curses.panel.update_panels()

   Actualiza la pantalla virtual después de los cambios en la pila del
   panel. Esto no llama a "curses.doupdate()", por lo que tendrás que
   hacerlo tú mismo.


Objetos de Panel
================

Los objetos panel, retornados por "new_panel()" arriba, son ventanas
con un orden de apilamiento. Siempre hay una ventana asociada a un
panel que determina el contenido, mientras que los métodos del panel
son responsables de la profundidad de la ventana en la pila del panel.

Los objetos de panel tienen los siguientes métodos:

Panel.above()

   Retorna el panel situado encima del panel actual.

Panel.below()

   Retorna el panel debajo del panel actual.

Panel.bottom()

   Empuja el panel hasta la parte inferior de la pila.

Panel.hidden()

   Retorna "True" si el panel está oculto (no visible), "False" en
   caso contrario.

Panel.hide()

   Ocultar el panel. Esto no elimina el objeto, solo hace que la
   ventana en la pantalla sea invisible.

Panel.move(y, x)

   Mueve el panel a las coordenadas de pantalla``(y, x)``.

Panel.replace(win)

   Cambia la ventana asociada con el panel a la ventana *win*.

Panel.set_userptr(obj)

   Establece el puntero de usuario del panel en *obj*. Esto se usa
   para asociar un dato arbitrario con el panel y puede ser cualquier
   objeto de Python.

Panel.show()

   Muestra el panel (que podría haber estado oculto).

Panel.top()

   Empuja el panel hacia la parte superior de la pila.

Panel.userptr()

   Retorna el puntero del usuario para el panel. Puede ser cualquier
   objeto de Python.

Panel.window()

   Retorna el objeto de ventana asociado con el panel.
