SYNCOK(3XCURSES) X/Open Curses Library Functions SYNCOK(3XCURSES)

NAME

syncok, wcursyncup, wsyncdown, wsyncup - synchronize window with its
parents or children

SYNOPSIS

cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
-R /usr/xpg4/lib -lcurses [ library... ]

c89 [ flag... ] file... -lcurses [ library... ]

#include <curses.h>

int syncok(WINDOW *win, bool bf);


void wcursyncup(WINDOW *win);


void wsyncdown(WINDOW *win);


void wsyncup(WINDOW *win);

PARAMETERS

win
Is a pointer to a window.


bf
Is a Boolean expression.

DESCRIPTION

The syncok() function uses the value of bf to determine whether or
not the window win's ancestors are implicitly touched whenever there
is a change to win. If bf is TRUE, this touching occurs. If bf is
FALSE, it does not occur. The initial value for bf is FALSE.


The wcursyncup() function moves the cursor in win's ancestors to
match its position in win.


The wsyncdown() function touches win if any of its ancestors have
been touched.


The wsyncup() function touches all ancestors of win.

RETURN VALUES

On success, the syncok() function returns OK. Otherwise, it returns
ERR.


The other functions do not return a value.

ERRORS

None.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+

SEE ALSO

derwin(3XCURSES), doupdate(3XCURSES), is_linetouched(3XCURSES),
libcurses(3XCURSES), attributes(7), standards(7)

June 5, 2002 SYNCOK(3XCURSES)