Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.


PANEL_ABOVE(3)             Library Functions Manual             PANEL_ABOVE(3)

NAME
     top_panel, bottom_panel, panel_above, panel_below - z-order of panels

LIBRARY
     Z-order for curses windows (libpanel, -lpanel)

SYNOPSIS
     #include <panel.h>

     int
     top_panel(PANEL *p);

     int
     bottom_panel(PANEL *p);

     PANEL *
     panel_above(PANEL *p);

     PANEL *
     panel_below(PANEL *p);

DESCRIPTION
     Newly created panels are placed at the top of the deck.  The z-order of a
     visible panel can be changed with the functions top_panel() and
     bottom_panel() that move it to the top and bottom of the deck
     respectively.

     For a visible panel its neighbors in the deck can be obtained with
     panel_above() and panel_below().  The bottom and top panels can be
     obtained by passing a NULL argument to panel_above() and panel_below(),
     respectively.

IMPLEMENTATION NOTES
     The top_panel() function will return an error if the panel is currently
     hidden.  Use show_panel(3) to make a hidden panel visible again and put
     it at the top of the deck.  This is the behaviour specified by the
     original AT&T System V UNIX panel library.

     In the ncurses implementation of the panel library show_panel() and
     top_panel() are identical and handle both visible and hidden panels.
     This may be a source of bugs in programs tested only against ncurses.

RETURN VALUES
     Functions returning pointers will return NULL if an error is detected.
     The functions that return an int will return one of the following values:

     OK       The function completed successfully.
     ERR      An error occurred in the function.

SEE ALSO
     panel(3)

NetBSD 10.99                   October 28, 2015                   NetBSD 10.99