'\" te
.\" Copyright 1989 AT&T
.\" Portions Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved.
.TH panel_above 3CURSES "31 Dec 1996" "SunOS 5.11" "Curses Library Functions"
.SH NAME
panel_above, panel_below \- panels deck traversal primitives
.SH SYNOPSIS
.LP
.nf
\fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lpanel\fR \fB -lcurses \fR [ \fIlibrary\fR .. ]
#include <panel.h>



\fBPANEL *\fR\fBpanel_above\fR(\fBPANEL *\fR\fIpanel\fR);
.fi

.LP
.nf
\fBPANEL *\fR\fBpanel_below\fR(\fBPANEL *\fR\fIpanel\fR);
.fi

.SH DESCRIPTION
.sp
.LP
\fBpanel_above()\fR returns a pointer to the panel just above \fIpanel\fR, or \fBNULL\fR if \fIpanel\fR is the top panel. \fBpanel_below()\fR returns a pointer to the panel just below \fIpanel\fR, or \fBNULL\fR if \fIpanel\fR is the bottom panel.
.sp
.LP
If \fBNULL\fR is passed for \fIpanel\fR, \fBpanel_above()\fR returns a pointer to the bottom panel in the deck, and \fBpanel_below()\fR returns a pointer to the top panel in the deck.
.SH RETURN VALUES
.sp
.LP
\fBNULL\fR is returned if an error occurs.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
MT-LevelUnsafe
.TE

.SH SEE ALSO
.sp
.LP
\fBcurses\fR(3CURSES), \fBpanels\fR(3CURSES), \fBattributes\fR(5)
.SH NOTES
.sp
.LP
These routines allow traversal of the deck of currently visible panels.
.sp
.LP
The header \fB<panel.h>\fR automatically includes the header \fB<curses.h>\fR\&.