Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
TICKIT_WINDOW_FLUSH(3)	    Library Functions Manual	  TICKIT_WINDOW_FLUSH(3)

NAME
     tickit_window_flush - invoke pending events on the window hierarchy

SYNOPSIS
     #include <tickit.h>

     void tickit_window_flush(TickitWindow *win);

     Link with -ltickit.

DEPRECATED
     This  function  is  deprecated  and should not be used in new programs. In-
     stead, obtain the root window from the toplevel Tickit instance by  calling
     tickit_get_rootwin(3), and its pending events will automatically be managed
     by the toplevel instance tickit_run(3) function.

DESCRIPTION
     tickit_window_flush()  causes  any pending activity in the window hierarchy
     to be performed. First it makes any window ordering changes that have  been
     queued by tickit_window_raise(3) and tickit_window_lower(3), then fires any
     TICKIT_EV_EXPOSE  events  to render newly-exposed areas, before finally re-
     setting the terminal cursor to the state required by whichever  window  has
     input focus. This function must be invoked on the root window instance.

     An  application  working at the window level would typically use this func-
     tion in conjunction with input even waiting, to drive the main loop of  the
     core logic. Such a loop may look like:

       while(1) {
	 tickit_window_flush(rootwin);
	 tickit_term_input_wait_msec(term, -1);
       }

     There  is no adverse effect of calling this function when here are no pend-
     ing events on the window instance. An application that makes use of  multi-
     ple  root	windows across multiple terminal instances in a multi-head setup
     can safely invoke it on all the root windows at once.

RETURN VALUE
     tickit_window_flush() returns no value.

SEE ALSO
     tickit_window_new(3), tickit_window_expose(3), tickit_window_bind_event(3),
     tickit_window(7), tickit(7)

							  TICKIT_WINDOW_FLUSH(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tickit_window_flush&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help