GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
TICKIT_WINDOW_NEW(3) FreeBSD Library Functions Manual TICKIT_WINDOW_NEW(3)

tickit_window_new - create a new sub-window

#include <tickit.h>

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

Link with -ltickit.

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.

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

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

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.