Panels are curses(3x) windows with the added feature of
depth. Panel functions allow the use of stacked windows
and ensure the proper portions of each window and the
@@ -94,21 +91,20 @@
minfo curses does.
-
new_panel(win)
allocates a PANEL structure, associates it with
win, places the panel on the top of the stack
(causes it to be displayed above any other
panel) and returns a pointer to the new panel.
- update_panels()
+ update_panels
refreshes the virtual screen to reflect the rela-
tions between the panels in the stack, but does not
- call doupdate() to refresh the physical screen.
- Use this function and not wrefresh or wnoutrefresh.
+ call doupdate to refresh the physical screen. Use
+ this function and not wrefresh or wnoutrefresh.
update_panels may be called more than once before a
- call to doupdate(), but doupdate() is the function
+ call to doupdate, but doupdate is the function
responsible for updating the physical screen.
del_panel(pan)
@@ -122,8 +118,8 @@
lost, merely removed from the stack.
panel_hidden(pan)
- returns TRUE if the panel is in the panel stack,
- FALSE if it is not. If the panel is a null
+ returns TRUE if the panel is in the panel stack,
+ FALSE if it is not. If the panel is a null
pointer, return ERR.
show_panel(pan)
@@ -142,8 +138,8 @@
moves the given panel window so that its upper-left
corner is at starty, startx. It does not change
the position of the panel in the stack. Be sure to
- use this function, not mvwin(), to move a panel
- window.
+ use this function, not mvwin, to move a panel win-
+ dow.
replace_panel(pan,window)
replaces the current window of panel with window
@@ -172,57 +168,50 @@
returns a pointer to the window of the given panel.
-
-
DIAGNOSTICS
- Each routine that returns a pointer returns NULL if an
- error occurs. Each routine that returns an int value
+
+ Each routine that returns a pointer returns NULL if an
+ error occurs. Each routine that returns an int value
returns OK if it executes successfully and ERR if not.
-
-
COMPATIBILITY
- Reasonable care has been taken to ensure compatibility
- with the native panel facility introduced in SVr3.2
- (inspection of the SVr4 manual pages suggests the
- programming interface is unchanged). The PANEL data
- structures are merely similar. The programmer is cau-
- tioned not to directly use PANEL fields.
-
- The functions show_panel() and top_panel() are identical
- in this implementation, and work equally well with dis-
- played or hidden panels. In the native System V implemen-
- tation, show_panel() is intended for making a hidden panel
- visible (at the top of the stack) and top_panel() is
- intended for making an already-visible panel move to the
- top of the stack. You are cautioned to use the correct
- function to ensure compatibility with native panel
- libraries.
+
+ Reasonable care has been taken to ensure compatibility
+ with the native panel facility introduced in SVr3.2
+ (inspection of the SVr4 manual pages suggests the program-
+ ming interface is unchanged). The PANEL data structures
+ are merely similar. The programmer is cautioned not to
+ directly use PANEL fields.
+ The functions show_panel and top_panel are identical in
+ this implementation, and work equally well with displayed
+ or hidden panels. In the native System V implementation,
+ show_panel is intended for making a hidden panel visible
+ (at the top of the stack) and top_panel is intended for
+ making an already-visible panel move to the top of the
+ stack. You are cautioned to use the correct function to
+ ensure compatibility with native panel libraries.
-
In your library list, libpanel.a should be before libn-
curses.a; that is, you want to say `-lpanel -lncurses',
not the other way around (which would usually give a link-
error).
-
Originally written by Warren Tucker <wht@n4hgf.mt-
park.ga.us>, primarily to assist in porting u386mon to
systems without a native panels library. Repackaged for
@@ -232,10 +221,19 @@
panel(3x)