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 par- ent, using the given rectangle as its initial geometry relative to its par- ent. The flags argument is a bitmask of flags influencing the initial be- haviour 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 dis- play. This flag causes it to be added at the bottom of the list, ap- pearing 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 auto- matically adjusted so that the new window still appears at the given geometry position relative to the window passed as the parent argu- ment. 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 de- stroyed. 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_ex- pose(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.1.quarterly>