NAME

       tickit_window_new - create a new sub-window

SYNOPSIS

       #include <tickit.h>

       TickitWindow *tickit_window_new(TickitWindow *parent, TickitRect rect,
                TickitWindowFlags flags);

       Link with -ltickit.

DESCRIPTION

       tickit_window_new()  creates  a  new  sub-window as a child of the given parent, using the
       given rectangle as its initial geometry relative to its parent. The flags  argument  is  a
       bitmask of flags influencing the initial behaviour of the child window.

       TICKIT_WINDOW_HIDDEN
              The  new  child  window  will  be created in the hidden state initially. No pending
              expose event  will  occur  because  of  it.  It  can  later  be  shown  by  calling
              tickit_window_show(3).

       TICKIT_WINDOW_LOWEST
              Normally  the most recently-added child window is ordered at the top of the list in
              its parent, making it appear front-most in the display. This flag causes it  to  be
              added at the bottom of the list, appearing lowest-most instead.

       TICKIT_WINDOW_ROOT_PARENT
              The  new  child  window will have the root window of the window tree as its parent,
              instead of the given window. The position will be automatically  adjusted  so  that
              the  new window still appears at the given geometry position relative to the window
              passed as the parent argument.

       TICKIT_WINDOW_STEAL_INPUT
              The  new  child  window  will  initially  be  set  to  steal  input   events;   see
              tickit_window_set_steal_input(3).

              This  flag  is  not  useful  when combined with TICKIT_WINDOW_LOWEST, as the input-
              stealing behaviour only applies while the window is front-most within its parent.

       TICKIT_WINDOW_POPUP
              A  convenient   shortcut   to   specifying   both   TICKIT_WINDOW_ROOT_PARENT   and
              TICKIT_WINDOW_STEAL_INPUT  flags.  This  is  useful  for  implementing popup dialog
              windows, menus, and other such UI behaviours.

       The reference count of a newly-constructed window  instance  will  be  one.  This  can  be
       incremented or decremented using tickit_window_ref(3) and tickit_window_unref(3). When its
       reference count reaches zero it is destroyed.

RETURN VALUE

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

SEE ALSO

       tickit_window_new_root(3),      tickit_window_bind_event(3),      tickit_window_expose(3),
       tickit_window_close(3), tickit_window(7), tickit(7)

                                                                             TICKIT_WINDOW_NEW(3)