HP-UX Reference (11i v2 07/12) - 3 Library Functions N-Z (vol 7)

syncok(3X) syncok(3X)

(ENHANCED CURSES)

NAME

syncok(), wcursyncup(), wsyncdown(), wsyncup() - synchronise a window with its parents or children

SYNOPSIS

#include <curses.h>

int syncok(WINDOW *win, bool bf);

void wcursyncup(WINDOW *win);

void wsyncdown(WINDOW *win);

void wsyncup(WINDOW *win);

DESCRIPTION

The syncok() function determines whether all ancestors of the speciﬁed 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() function updates the current cursor position of the ancestors of win to reﬂect the

current cursor position of win.

The

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

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

RETURN VALUE

Upon successful completion,

syncok() returns OK. Otherwise, it returns ERR.

The other functions do not return a value.

ERRORS

No errors are deﬁned.

APPLICATION USAGE

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