syncok.3x (2010 09)

s
syncok(3X) syncok(3X)
(ENHANCED CURSES)
NAME
syncok(), wcursyncup(), wsyncdown(), wsyncup() - synchronize 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 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() function updates the current cursor position of the ancestors of win to reflect 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 defined.
APPLICATION USAGE
Applications seldom call
wsyncdown() because it is called by all refresh operations.
SEE ALSO
doupdate(3X), is_linetouched(3X), <curses.h>.
HP-UX 11i Version 3: September 2010 1 Hewlett-Packard Company 1

Summary of content (2 pages)