diff options
Diffstat (limited to 'upstream/opensuse-leap-15-6/man3/panel.3curses')
| -rw-r--r-- | upstream/opensuse-leap-15-6/man3/panel.3curses | 204 |
1 files changed, 204 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man3/panel.3curses b/upstream/opensuse-leap-15-6/man3/panel.3curses new file mode 100644 index 00000000..c001f2c4 --- /dev/null +++ b/upstream/opensuse-leap-15-6/man3/panel.3curses @@ -0,0 +1,204 @@ +.\"*************************************************************************** +.\" Copyright (c) 1998-2016,2017 Free Software Foundation, Inc. * +.\" * +.\" Permission is hereby granted, free of charge, to any person obtaining a * +.\" copy of this software and associated documentation files (the * +.\" "Software"), to deal in the Software without restriction, including * +.\" without limitation the rights to use, copy, modify, merge, publish, * +.\" distribute, distribute with modifications, sublicense, and/or sell * +.\" copies of the Software, and to permit persons to whom the Software is * +.\" furnished to do so, subject to the following conditions: * +.\" * +.\" The above copyright notice and this permission notice shall be included * +.\" in all copies or substantial portions of the Software. * +.\" * +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * +.\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * +.\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * +.\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR * +.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. * +.\" * +.\" Except as contained in this notice, the name(s) of the above copyright * +.\" holders shall not be used in advertising or otherwise to promote the * +.\" sale, use or other dealings in this Software without prior written * +.\" authorization. * +.\"*************************************************************************** +.\" +.\" $Id: panel.3x,v 1.24 2017/11/25 20:31:13 tom Exp $ +.TH panel 3CURSES "" +.ie \n(.g .ds `` \(lq +.el .ds `` `` +.ie \n(.g .ds '' \(rq +.el .ds '' '' +.SH NAME +panel \- panel stack extension for curses +.SH SYNOPSIS +\fB#include <panel.h>\fR +.P +\fBcc [flags] sourcefiles \-lpanel \-lncurses\fR +.P +\fBPANEL *new_panel(WINDOW *win);\fR +.br +\fBint bottom_panel(PANEL *pan);\fR +.br +\fBint top_panel(PANEL *pan);\fR +.br +\fBint show_panel(PANEL *pan);\fR +.br +\fBvoid update_panels();\fR +.br +\fBint hide_panel(PANEL *pan);\fR +.br +\fBWINDOW *panel_window(const PANEL *pan);\fR +.br +\fBint replace_panel(PANEL *pan, WINDOW *window);\fR +.br +\fBint move_panel(PANEL *pan, int starty, int startx);\fR +.br +\fBint panel_hidden(const PANEL *pan);\fR +.br +\fBPANEL *panel_above(const PANEL *pan);\fR +.br +\fBPANEL *panel_below(const PANEL *pan);\fR +.br +\fBint set_panel_userptr(PANEL *pan, const void *ptr);\fR +.br +\fBconst void *panel_userptr(const PANEL *pan);\fR +.br +\fBint del_panel(PANEL *pan);\fR +.br +.SH DESCRIPTION +Panels are \fBncurses\fR(3NCURSES) 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 curses \fBstdscr\fR window are +hidden or displayed when panels are added, moved, modified or removed. +The set of currently visible panels is the stack of panels. The +\fBstdscr\fR window is beneath all panels, and is not considered part +of the stack. +.P +A window is associated with every panel. The panel routines enable +you to create, move, hide, and show panels, as well as position a +panel at any desired location in the stack. +.P +Panel routines are a functional layer added to \fBncurses\fR(3NCURSES), make only +high-level curses calls, and work anywhere terminfo curses does. +.SH FUNCTIONS +.TP +.B new_panel(win) +allocates a \fBPANEL\fR structure, associates it with +\fBwin\fR, 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. +.TP +.B update_panels +refreshes the virtual screen to reflect the relations between the +panels in the stack, but does not call \fBdoupdate\fP to refresh the +physical screen. +Use this function and not \fBwrefresh\fP or \fBwnoutrefresh\fP. +.B update_panels +may be called more than once before a call to +\fBdoupdate\fP, but \fBdoupdate\fP is the function responsible for updating +the physical screen. +.TP +.B del_panel(pan) +removes the given panel from the stack and deallocates the +\fBPANEL\fR structure (but not its associated window). +.TP +.B hide_panel(pan) +removes the given panel from the panel stack and thus hides it from +view. The \fBPANEL\fR structure is not lost, merely removed from the stack. +.TP +.B panel_hidden(pan) +returns \fBTRUE\fP if the panel is in the panel stack, +\fBFALSE\fP if it is not. +If the panel is a null pointer, return \fBERR\fP. +.TP +.B show_panel(pan) +makes a hidden panel visible by placing it on top of the panels in the +panel stack. See COMPATIBILITY below. +.TP +.B top_panel(pan) +puts the given visible panel on top of all panels in the stack. See +COMPATIBILITY below. +.TP +.B bottom_panel(pan) +puts panel at the bottom of all panels. +.TP +.B move_panel(pan,starty,startx) +moves the given panel window so that its upper-left corner is at +\fBstarty\fR, \fBstartx\fR. It does not change the position of the +panel in the stack. Be sure to use this function, not \fBmvwin\fR, +to move a panel window. +.TP +.B replace_panel(pan,window) +replaces the current window of panel with \fBwindow\fR (useful, for +example if you want to resize a panel; if you're using \fBncurses\fR, +you can call \fBreplace_panel\fR on the output of \fBwresize\fR(3NCURSES)). +It does not change the position of the panel in the stack. +.TP +.B panel_above(pan) +returns a pointer to the panel above pan. If the panel argument is +\fB(PANEL *)0\fR, it returns a pointer to the bottom panel in the stack. +.TP +.B panel_below(pan) +returns a pointer to the panel just below pan. If the panel argument +is \fB(PANEL *)0\fR, it returns a pointer to the top panel in the stack. +.TP +.B set_panel_userptr(pan,ptr) +sets the panel's user pointer. +.TP +.B panel_userptr(pan) +returns the user pointer for a given panel. +.TP +.B panel_window(pan) +returns a pointer to the window of the given panel. +.SH DIAGNOSTICS +Each routine that returns a pointer returns \fBNULL\fR if an error +occurs. Each routine that returns an int value returns \fBOK\fR if it +executes successfully and \fBERR\fR if not. +.SH COMPATIBILITY +Reasonable care has been taken to ensure compatibility +with the native panel facility introduced in System V (inspection of +the SVr4 manual pages suggests the programming interface is unchanged). +The \fBPANEL\fR data structures are merely similar. The programmer +is cautioned not to directly use \fBPANEL\fR fields. +.P +The functions \fBshow_panel\fR and \fBtop_panel\fR are identical +in this implementation, and work equally well with displayed or hidden +panels. In the native System V implementation, \fBshow_panel\fR is +intended for making a hidden panel visible (at the top of the stack) +and \fBtop_panel\fR 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. +.SH NOTE +In your library list, libpanel.a should be before libncurses.a; that is, +you should say \*(``\-lpanel \-lncurses\*('', not the other way around +(which would give a link-error with static libraries). +.SH PORTABILITY +.PP +The panel facility was documented in SVr4.2 in +\fICharacter User Interface Programming (UNIX SVR4.2)\fP. +.PP +It is not part of X/Open Curses. +.PP +Aside from ncurses, only systems based on SVr4 source code, +e.g., Solaris provide this library. +.SH FILES +.P +panel.h +interface for the panels library +.P +libpanel.a +the panels library itself +.SH SEE ALSO +\fBncurses\fR(3NCURSES), +\fBcurses_variables\fR(3NCURSES), +.PP +This describes \fBncurses\fR +version 6.1 (patch 20180317). +.SH AUTHOR +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 ncurses by Zeyd ben-Halim. |