FreeBSD Manual Pages
TICKIT_WINDOW_NEW(3) Library Functions Manual TICKIT_WINDOW_NEW(3) 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 ini- tially. 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 ap- pears 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_PAR- ENT and TICKIT_WINDOW_STEAL_INPUT flags. This is useful for im- plementing popup dialog windows, menus, and other such UI behav- iours. 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 de- stroyed. RETURN VALUE If successful, tickit_window_new() returns a pointer to the new in- stance. SEE ALSO tickit_window_new_root(3), tickit_window_bind_event(3), tickit_win- dow_expose(3), tickit_window_close(3), tickit_window(7), tickit(7) TICKIT_WINDOW_NEW(3)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tickit_window_new&sektion=3&manpath=FreeBSD+Ports+15.0>