NAME

       tickit_window_new_root - create a new toplevel root window

SYNOPSIS

       #include <tickit.h>

       TickitWindow *tickit_window_new_root(TickitTerm *term);

       Link with -ltickit.

DEPRECATED

       This  function  is  deprecated and should not be used in new programs. Instead, obtain the
       root window from the toplevel Tickit instance by calling tickit_get_rootwin(3).

DESCRIPTION

       tickit_window_new_root() creates a new toplevel TickitWindow  instance  to  represent  the
       drawing area on the given terminal instance. The terminal instance is stored by the window
       itself, and is used for flushing the TickitRenderBuffer to when expose events  occur.  The
       root  window  will  increase  the  reference  count  of  its backing terminal by one; this
       reference will be dropped when the window is destroyed.

       The root window behaves  similar  to  other  windows  within  the  application,  with  the
       following differences:

       *      Its position remains fixed at zero, and should not be set by the application.

       *      Its  size  is  managed automatically by observing resize events from the underlying
              terminal instance, and should not be set by the application.

       *      It is initially fully-damaged after construction, and will have  a  pending  expose
              event waiting to occur.

RETURN VALUE

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

SEE ALSO

       tickit_window_new(3),        tickit_window_get_term(3),       tickit_window_bind_event(3),
       tickit_window_expose(3), tickit_window(7), tickit(7)

                                                                        TICKIT_WINDOW_NEW_ROOT(3)