Provided by: libtickit-dev_0.4.3-2_amd64 bug

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)