curs_opaque.3x - Man Page
obtain curses window properties
Synopsis
#include <curses.h> bool is_cleared(const WINDOW *win); bool is_idcok(const WINDOW *win); bool is_idlok(const WINDOW *win); bool is_immedok(const WINDOW *win); bool is_keypad(const WINDOW *win); bool is_leaveok(const WINDOW *win); bool is_nodelay(const WINDOW *win); bool is_notimeout(const WINDOW *win); bool is_pad(const WINDOW *win); bool is_scrollok(const WINDOW *win); bool is_subwin(const WINDOW *win); bool is_syncok(const WINDOW *win); WINDOW * wgetparent(const WINDOW *win); int wgetdelay(const WINDOW *win); int wgetscrreg(const WINDOW *win, int *top, int *bottom);
Description
ncurses provides functions returning properties of a WINDOW structure, allowing it to be “opaque” if the application defines the NCURSES_OPAQUE preprocessor symbol. Opacity in this sense means that the members of struct data types are not directly accessible (for instance, through “.” or “->” operators), but instead must be queried and/or set via library functions. Advantages of opacity include greater abstraction and improved management of concurrent accesses to data structures, keeping object states coherent.
- is_cleared
returns the value set by clearok(3X).
- is_idcok
returns the value set by idcok(3X).
- is_idlok
returns the value set by idlok(3X).
- is_immedok
returns the value set by immedok(3X).
- is_keypad
returns the value set by keypad(3X).
- is_leaveok
returns the value set by leaveok(3X).
- is_nodelay
returns the value set by nodelay(3X).
- is_notimeout
returns the value set by notimeout(3X).
- is_pad
returns TRUE if the window is a pad; that is, it was created by newpad(3X).
- is_scrollok
returns the value set by scrollok(3X).
- is_subwin
returns TRUE if the window is a subwindow, that is, it was created by subwin(3X) or derwin(3X).
- is_syncok
returns the value set by syncok(3X).
- wgetdelay
returns the delay timeout set by wtimeout(3X).
- wgetparent
returns the parent WINDOW pointer for subwindows, or NULL for windows having no parent.
- wgetscrreg
stores the the top and bottom rows for the scrolling margin set by wsetscrreg(3X) in the corresponding arguments, returning ERR upon failure and OK upon successful completion.
Return Value
These functions return TRUE or FALSE except as noted.
Notes
ncurses provides both a C function and a preprocessor macro for each function documented in this page.
Portability
These routines are specific to ncurses. They were not supported on Version 7, BSD or System V implementations. It is recommended that any code depending on ncurses extensions be conditioned using NCURSES_VERSION.
See Also
curses(3X), curs_inopts(3X), curs_outopts(3X), curs_threads(3X), curs_window(3X)
Referenced By
The man pages is_cleared.3x(3), is_idcok.3x(3), is_idlok.3x(3), is_immedok.3x(3), is_keypad.3x(3), is_leaveok.3x(3), is_nodelay.3x(3), is_notimeout.3x(3), is_pad.3x(3), is_scrollok.3x(3), is_subwin.3x(3), is_syncok.3x(3), wgetdelay.3x(3), wgetparent.3x(3) and wgetscrreg.3x(3) are aliases of curs_opaque.3x(3).