blob: 6c9cfaa18a35164dfcd3250c7b1a7cc03310a48b [file] [log] [blame]
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +05301.\"***************************************************************************
2.\" Copyright (c) 2007 Free Software Foundation, Inc. *
3.\" *
4.\" Permission is hereby granted, free of charge, to any person obtaining a *
5.\" copy of this software and associated documentation files (the *
6.\" "Software"), to deal in the Software without restriction, including *
7.\" without limitation the rights to use, copy, modify, merge, publish, *
8.\" distribute, distribute with modifications, sublicense, and/or sell *
9.\" copies of the Software, and to permit persons to whom the Software is *
10.\" furnished to do so, subject to the following conditions: *
11.\" *
12.\" The above copyright notice and this permission notice shall be included *
13.\" in all copies or substantial portions of the Software. *
14.\" *
15.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS *
16.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF *
17.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. *
18.\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *
19.\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *
20.\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR *
21.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. *
22.\" *
23.\" Except as contained in this notice, the name(s) of the above copyright *
24.\" holders shall not be used in advertising or otherwise to promote the *
25.\" sale, use or other dealings in this Software without prior written *
26.\" authorization. *
27.\"***************************************************************************
28.\"
29.\" $Id: curs_opaque.3x,v 1.6 2007/09/08 18:49:13 tom Exp $
30.TH curs_opaque 3X ""
31.na
32.hy 0
33.SH NAME
34\fBis_cleared\fR,
35\fBis_idlok\fR,
36\fBis_idcok\fR,
37\fBis_immedok\fR,
38\fBis_keypad\fR,
39\fBis_leaveok\fR,
40\fBis_nodelay\fR,
41\fBis_timeout\fR,
42\fBis_scrollok\fR,
43\fBis_syncok\fR - \fBcurses\fR window properties
44.ad
45.hy
46.SH SYNOPSIS
47\fB#include <curses.h>\fR
48.sp
49\fBbool is_cleared(const WINDOW *win);\fR
50.br
51\fBbool is_idcok(const WINDOW *win);\fR
52.br
53\fBbool is_idlok(const WINDOW *win);\fR
54.br
55\fBbool is_immedok(const WINDOW *win);\fR
56.br
57\fBbool is_keypad(const WINDOW *win);\fR
58.br
59\fBbool is_leaveok(const WINDOW *win);\fR
60.br
61\fBbool is_nodelay(const WINDOW *win);\fR
62.br
63\fBbool is_notimeout(const WINDOW *win);\fR
64.br
65\fBbool is_scrollok(const WINDOW *win);\fR
66.br
67\fBbool is_syncok(const WINDOW *win);\fR
68.br
69\fBWINDOW * wgetparent(const WINDOW *win);\fR
70.br
71\fBint wgetscrreg(const WINDOW *win, int *top, int *bottom);\fR
72.br
73.SH DESCRIPTION
74This implementation provides functions which return properties
75set in the WINDOW structure, allowing it to be ``opaque'' if
76the symbol \fBNCURSES_OPAQUE\fR is defined:
77.TP 5
78\fBis_cleared\fR
79returns the value set in \fBclearok\fR
80.TP 5
81\fBis_idcok\fR
82returns the value set in \fBidcok\fR
83.TP 5
84\fBis_idlok\fR
85returns the value set in \fBidlok\fR
86.TP 5
87\fBis_immedok\fR
88returns the value set in \fBimmedok\fR
89.TP 5
90\fBis_keypad\fR
91returns the value set in \fBkeypad\fR
92.TP 5
93\fBis_leaveok\fR
94returns the value set in \fBleaveok\fR
95.TP 5
96\fBis_nodelay\fR
97returns the value set in \fBnodelay\fR
98.TP 5
99\fBis_notimeout\fR
100returns the value set in \fBnotimeout\fR
101.TP 5
102\fBis_scrollok\fR
103returns the value set in \fBscrollok\fR
104.TP 5
105\fBis_syncok\fR
106returns the value set in \fBsyncok\fR
107.TP 5
108\fBwgetparent\fR
109returns the parent WINDOW pointer for subwindows,
110or NULL for windows having no parent.
111.TP 5
112\fBwgetscrreg\fR
113returns the top and bottom rows for the scrolling margin as set in \fBwsetscrreg\fP.
114.SH RETURN VALUE
115These functions all return TRUE or FALSE, except as noted.
116.SH NOTES
117Both a macro and a function are provided for each name.
118.SH PORTABILITY
119These routines are specific to ncurses.
120They were not supported on Version 7, BSD or System V implementations.
121It is recommended that any code depending on ncurses extensions
122be conditioned using NCURSES_VERSION.
123.SH SEE ALSO
124\fBcurses\fR(3X),
125\fBcurs_inopts\fR(3X),
126\fBcurs_outopts\fR(3X),
127\fBcurs_window\fR(3X)
128.\"#
129.\"# The following sets edit modes for GNU EMACS
130.\"# Local Variables:
131.\"# mode:nroff
132.\"# fill-column:79
133.\"# End: