1TICKIT_WINDOW_FLUSH(3)     Library Functions Manual     TICKIT_WINDOW_FLUSH(3)
2
3
4

NAME

6       tickit_window_flush - invoke pending events on the window hierarchy
7

SYNOPSIS

9       #include <tickit.h>
10
11       void tickit_window_flush(TickitWindow *win);
12
13       Link with -ltickit.
14

DEPRECATED

16       This  function  is  deprecated  and should not be used in new programs.
17       Instead, obtain the root window from the toplevel  Tickit  instance  by
18       calling  tickit_get_rootwin(3),  and  its pending events will automati‐
19       cally be managed by the toplevel instance tickit_run(3) function.
20

DESCRIPTION

22       tickit_window_flush() causes any pending activity in the window hierar‐
23       chy  to  be  performed. First it makes any window ordering changes that
24       have been queued by tickit_window_raise(3) and  tickit_window_lower(3),
25       then  fires  any TICKIT_EV_EXPOSE events to render newly-exposed areas,
26       before finally resetting the terminal cursor to the state  required  by
27       whichever  window has input focus. This function must be invoked on the
28       root window instance.
29
30       An application working at the window level  would  typically  use  this
31       function in conjunction with input even waiting, to drive the main loop
32       of the core logic. Such a loop may look like:
33
34         while(1) {
35           tickit_window_flush(rootwin);
36           tickit_term_input_wait_msec(term, -1);
37         }
38
39       There is no adverse effect of calling this function when  here  are  no
40       pending events on the window instance. An application that makes use of
41       multiple root windows across multiple terminal instances  in  a  multi-
42       head setup can safely invoke it on all the root windows at once.
43

RETURN VALUE

45       tickit_window_flush() returns no value.
46

SEE ALSO

48       tickit_window_new(3),        tickit_window_expose(3),       tickit_win‐
49       dow_bind_event(3), tickit_window(7), tickit(7)
50
51
52
53                                                        TICKIT_WINDOW_FLUSH(3)
Impressum