This document is for an old version of Python that is no longer supported. You should upgrade, and read the Python documentation for the current stable release.

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