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

NAME

6       tickit_window_new_root - create a new toplevel root window
7

SYNOPSIS

9       #include <tickit.h>
10
11       TickitWindow *tickit_window_new_root(TickitTerm *term);
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).
19

DESCRIPTION

21       tickit_window_new_root()  creates  a new toplevel TickitWindow instance
22       to represent the drawing area on the given terminal instance. The  ter‐
23       minal instance is stored by the window itself, and is used for flushing
24       the TickitRenderBuffer to when expose events  occur.  The  root  window
25       will  increase the reference count of its backing terminal by one; this
26       reference will be dropped when the window is destroyed.
27
28       The root window behaves similar to other windows  within  the  applica‐
29       tion, with the following differences:
30
31       *      Its position remains fixed at zero, and should not be set by the
32              application.
33
34       *      Its size is managed automatically  by  observing  resize  events
35              from  the underlying terminal instance, and should not be set by
36              the application.
37
38       *      It is initially fully-damaged after construction, and will  have
39              a pending expose event waiting to occur.
40

RETURN VALUE

42       If  successful,  tickit_window_new_root()  returns a pointer to the new
43       instance.
44

SEE ALSO

46       tickit_window_new(3),      tickit_window_get_term(3),       tickit_win‐
47       dow_bind_event(3), tickit_window_expose(3), tickit_window(7), tickit(7)
48
49
50
51                                                     TICKIT_WINDOW_NEW_ROOT(3)
Impressum