1TICKIT_WINDOW_FLUSH(3) Library Functions Manual TICKIT_WINDOW_FLUSH(3)
2
3
4
6 tickit_window_flush - invoke pending events on the window hierarchy
7
9 #include <tickit.h>
10
11 void tickit_window_flush(TickitWindow *win);
12
13 Link with -ltickit.
14
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
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
45 tickit_window_flush() returns no value.
46
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)