panel_above(3) - NetBSD Manual Pages

Command: Section: Arch: Collection:  
PANEL_ABOVE(3)          NetBSD 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 respec- tively. 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 origi- nal 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 9.99 October 28, 2015 NetBSD 9.99
Powered by man-cgi (2021-06-01). Maintained for NetBSD by Kimmo Suominen. Based on man-cgi by Panagiotis Christias.