syncok(CURSES)

syncok -- synchronise a window with its

parents or children

Synopsis

cc [options] file -lcurses

#include <curses.h>

int syncok(WINDOW *win, bool bf);

void wcursyncup(WINDOW *win);

void wsyncdown(WINDOW *win);

void wsyncup(WINDOW *win);

Description

The syncok(CURSES) function determines whether all ancestors of the specified window are implicitly touched whenever there is a change in the window. If bf is TRUE, such implicit touching occurs. If bf is FALSE, such implicit touching does not occur. The initial state is FALSE.

The wcursyncup(CURSES) function updates the current cursor position of the ancestors of win to reflect the current cursor position of win.

The wsyncdown(CURSES) function touches win if any ancestor window has been touched.

The wsyncup(CURSES) function unconditionally touches all ancestors of win.

Return value

Upon successful completion, syncok(CURSES) returns OK. Otherwise, it returns ERR.

The other functions do not return a value.

Errors

No errors are defined.

Usage

Applications seldom call wsyncdown(CURSES) because it is called by all refresh operations.

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

doupdate(CURSES), is_linetouched(CURSES), curses(F)