DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

panels(S)


panels -- character based panels package

Syntax

cc ... -lpanel -lcurses

#include <panel.h>

Description

The panels(S) library is built using the curses(S) library, and any program using panels routines must call one of the curses initialization routines such as initscr(S).

The panels package gives the applications programmer a way to have depth relationships between curses windows; a curses window is associated with every panel. The panels routines let curses windows overlap without making visible the overlapped portions of underlying windows. The initial curses( ) window, stdscr, lies beneath all panels. The set of currently visible panels is the deck of panels.

The panels package allows the applications programmer to create panels, fetch and set their associated windows, shuffle panels in the deck, and manipulate panels in other ways.

Routine name index

The following table lists each panels routine and the name of the manual page on which it is described.

panels  
Routine Name Manual Page Name
bottom_panel panel_top(S)
del_panel panel_new(S)
hide_panel panel_show(S)
move_panel panel_move(S)
new_panel panel_new(S)
panel_above panel_above(S)
panel_below panel_above(S)
panel_hidden panel_show(S)
panel_userptr panel_userptr(S)
panel_window panel_window(S)
replace_panel panel_window(S)
set_panel_userptr panel_userptr(S)
show_panel panel_show(S)
top_panel panel_top(S)
update_panels panel_update(S)

 panels
 Routine Name           Manual Page Name
 bottom_panel            panel_top(S)
 del_panel               panel_new(S)
 hide_panel              panel_show(S)
 move_panel              panel_move(S)
 new_panel               panel_new(S)
 panel_above             panel_above(S)
 panel_below             panel_above(S)
 panel_hidden            panel_show(S)
 panel_userptr           panel_userptr(S)
 panel_window            panel_window(S)
 replace_panel           panel_window(S)
 set_panel_userptr       panel_userptr(S)
 show_panel              panel_show(S)
 top_panel               panel_top(S)
 update_panels           panel_update(S)

Return values

Each panels routine that returns a pointer to an object returns NULL if an error occurs. Each panel routine that returns an integer, returns OK if it executes successfully and ERR if it does not.

Warning

The header file panel.h automatically includes the header file curses.h.

Files


/usr/lib/libpanel.a
the library

See also

curses(S) and S man pages whose names begin with ``panel_'' for detailed routine descriptions.

Standards conformance

panels(S) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003