PANEL_ABOVE(3CURSES) Curses Library Functions PANEL_ABOVE(3CURSES)
panel_above, panel_below - panels deck traversal primitives
cc [ flag ... ] file ... -lpanel -lcurses [ library .. ]
#include <panel.h>
PANEL *panel_above(PANEL *panel);
PANEL *panel_below(PANEL *panel);
panel_above() returns a pointer to the panel just above panel, or
NULL if panel is the top panel. panel_below() returns a pointer to
the panel just below panel, or NULL if panel is the bottom panel.
If NULL is passed for panel, panel_above() returns a pointer to the
bottom panel in the deck, and panel_below() returns a pointer to the
top panel in the deck.
NULL is returned if an error occurs.
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
curses(3CURSES), panels(3CURSES), attributes(7)
These routines allow traversal of the deck of currently visible
panels.
The header <panel.h> automatically includes the header <curses.h>.
December 31, 1996 PANEL_ABOVE(3CURSES)
NAME
panel_above, panel_below - panels deck traversal primitives
SYNOPSIS
cc [ flag ... ] file ... -lpanel -lcurses [ library .. ]
#include <panel.h>
PANEL *panel_above(PANEL *panel);
PANEL *panel_below(PANEL *panel);
DESCRIPTION
panel_above() returns a pointer to the panel just above panel, or
NULL if panel is the top panel. panel_below() returns a pointer to
the panel just below panel, or NULL if panel is the bottom panel.
If NULL is passed for panel, panel_above() returns a pointer to the
bottom panel in the deck, and panel_below() returns a pointer to the
top panel in the deck.
RETURN VALUES
NULL is returned if an error occurs.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
SEE ALSO
curses(3CURSES), panels(3CURSES), attributes(7)
NOTES
These routines allow traversal of the deck of currently visible
panels.
The header <panel.h> automatically includes the header <curses.h>.
December 31, 1996 PANEL_ABOVE(3CURSES)