1 .\"***************************************************************************
2 .\" Copyright 2020-2022,2023 Thomas E. Dickey *
3 .\" Copyright 2007-2014,2015 Free Software Foundation, Inc. *
5 .\" Permission is hereby granted, free of charge, to any person obtaining a *
6 .\" copy of this software and associated documentation files (the *
7 .\" "Software"), to deal in the Software without restriction, including *
8 .\" without limitation the rights to use, copy, modify, merge, publish, *
9 .\" distribute, distribute with modifications, sublicense, and/or sell *
10 .\" copies of the Software, and to permit persons to whom the Software is *
11 .\" furnished to do so, subject to the following conditions: *
13 .\" The above copyright notice and this permission notice shall be included *
14 .\" in all copies or substantial portions of the Software. *
16 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS *
17 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF *
18 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. *
19 .\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *
20 .\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *
21 .\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR *
22 .\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. *
24 .\" Except as contained in this notice, the name(s) of the above copyright *
25 .\" holders shall not be used in advertising or otherwise to promote the *
26 .\" sale, use or other dealings in this Software without prior written *
28 .\"***************************************************************************
30 .\" $Id: curs_opaque.3x,v 1.36 2023/10/07 21:19:07 tom Exp $
31 .TH curs_opaque 3X 2023-10-07 "ncurses 6.4" "Library calls"
58 obtain \fIcurses\fR window properties
61 \fB#include <curses.h>
63 \fBbool is_cleared(const WINDOW *\fIwin\fP);
64 \fBbool is_idcok(const WINDOW *\fIwin\fP);
65 \fBbool is_idlok(const WINDOW *\fIwin\fP);
66 \fBbool is_immedok(const WINDOW *\fIwin\fP);
67 \fBbool is_keypad(const WINDOW *\fIwin\fP);
68 \fBbool is_leaveok(const WINDOW *\fIwin\fP);
69 \fBbool is_nodelay(const WINDOW *\fIwin\fP);
70 \fBbool is_notimeout(const WINDOW *\fIwin\fP);
71 \fBbool is_pad(const WINDOW *\fIwin\fP);
72 \fBbool is_scrollok(const WINDOW *\fIwin\fP);
73 \fBbool is_subwin(const WINDOW *\fIwin\fP);
74 \fBbool is_syncok(const WINDOW *\fIwin\fP);
76 \fBWINDOW * wgetparent(const WINDOW *\fIwin\fP);
77 \fBint wgetdelay(const WINDOW *\fIwin\fP);
78 \fBint wgetscrreg(const WINDOW *\fIwin\fP, int *\fItop\fP, int *\fIbottom\fP);
81 \fIncurses\fP provides functions returning properties of a
82 \fI\%WINDOW\fP structure,
83 allowing it to be \*(``opaque\*('' if
84 the application defines the \fB\%NCURSES_OPAQUE\fP preprocessor symbol.
87 returns the value set by \fB\%clearok\fP(3X).
90 returns the value set by \fB\%idcok\fP(3X).
93 returns the value set by \fB\%idlok\fP(3X).
96 returns the value set by \fB\%immedok\fP(3X).
99 returns the value set by \fB\%keypad\fP(3X).
102 returns the value set by \fB\%leaveok\fP(3X).
105 returns the value set by \fB\%nodelay\fP(3X).
108 returns the value set by \fB\%notimeout\fP(3X).
111 returns \fBTRUE\fP if the window is a pad;
113 it created by \fB\%newpad\fP(3X).
116 returns the value set by \fB\%scrollok\fP(3X).
119 returns \fBTRUE\fP if the window is a subwindow,
121 it was created by \fB\%subwin\fP(3X) or \fB\%derwin\fP(3X).
124 returns the value set by \fB\%syncok\fP(3X).
127 returns the delay timeout set by \fB\%wtimeout\fP(3X).
130 returns the parent \fI\%WINDOW\fP pointer for subwindows,
131 or \fBNULL\fP for windows having no parent.
134 stores the the top and bottom rows for the scrolling margin set by
135 \fB\%wsetscrreg\fP(3X) in the corresponding arguments,
136 returning \fBERR\fP upon failure and \fBOK\fP upon successful
139 These functions return \fBTRUE\fP or \fBFALSE\fP except as noted.
141 \fIncurses\fP provides both a C function and a preprocessor macro for
142 each function documented in this page.
144 These routines are specific to \fIncurses\fP.
145 They were not supported on Version 7, BSD or System V implementations.
146 It is recommended that any code depending on \fIncurses\fP extensions
147 be conditioned using \fB\%NCURSES_VERSION\fP.
150 \fB\%curs_inopts\fP(3X),
151 \fB\%curs_outopts\fP(3X),
152 \fB\%curs_threads\fP(3X),
153 \fB\%curs_window\fP(3X)