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(5) 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(5), standards(5)

SunOS 5.10							    5 Jun 2002							  syncok(3XCURSES)