NAME
top_panel,
bottom_panel, panel_above,
panel_below —
z-order of panels
LIBRARY
library “libpanel”
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 functionstop_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.