# `curses.panel` — A panel stack extension for curses

Panels are windows with the added feature of depth, so they can be stacked on top of each other, and only the visible portions of each window will be displayed. Panels can be added, moved up or down in the stack, and removed.

## Funções

The module `curses.panel` defines the following functions:

curses.panel.bottom_panel()

  Retorna o painel inferior da pilha de painéis.

curses.panel.new_panel(win)

  Returns a panel object, associating it with the given window win. Be aware that you need to keep the returned panel object referenced explicitly. If you don’t, the panel object is garbage collected and removed from the panel stack.

curses.panel.top_panel()

  Returns the top panel in the panel stack.

curses.panel.update_panels()

  Updates the virtual screen after changes in the panel stack. This does not call `curses.doupdate()`, so you’ll have to do this yourself.

## Objetos Panel

Panel objects, as returned by `new_panel()` above, are windows with a stacking order. There’s always a window associated with a panel which determines the content, while the panel methods are responsible for the window’s depth in the panel stack.

Objetos Panel possuem os seguintes métodos:

Panel.above()

  Returns the panel above the current panel.

Panel.below()

  Retorna o painel abaixo do painel atual.

Panel.bottom()

  Push the panel to the bottom of the stack.

Panel.hidden()

  Returns `True` if the panel is hidden (not visible), `False` otherwise.

Panel.hide()

  Hide the panel. This does not delete the object, it just makes the window on screen invisible.

Panel.move(y, x)

  Move the panel to the screen coordinates `(y, x)`.

Panel.replace(win)

  Change the window associated with the panel to the window win.

Panel.set_userptr(obj)

  Set the panel’s user pointer to obj. This is used to associate an arbitrary piece of data with the panel, and can be any Python object.

Panel.show()

  Display the panel (which might have been hidden).

Panel.top()

  Push panel to the top of the stack.

Panel.userptr()

  Retorna o ponteiro do usuário para o painel. Pode ser qualquer objeto Python.

Panel.window()

  Returns the window object associated with the panel.