.TH TICKIT_WINDOW_NEW_ROOT 3
.SH NAME
tickit_window_new_root \- create a new toplevel root window
.SH SYNOPSIS
.EX
.B #include <tickit.h>
.sp
.BI "TickitWindow *tickit_window_new_root(TickitTerm *" term );
.EE
.sp
Link with \fI\-ltickit\fP.
.SH DEPRECATED
This function is deprecated and should not be used in new programs. Instead, obtain the root window from the toplevel \fBTickit\fP instance by calling \fBtickit_get_rootwin\fP(3).
.SH DESCRIPTION
\fBtickit_window_new_root\fP() creates a new toplevel \fBTickitWindow\fP instance to represent the drawing area on the given terminal instance. The terminal instance is stored by the window itself, and is used for flushing the \fBTickitRenderBuffer\fP to when expose events occur. The root window will increase the reference count of its backing terminal by one; this reference will be dropped when the window is destroyed.
.PP
The root window behaves similar to other windows within the application, with the following differences:
.IP *
Its position remains fixed at zero, and should not be set by the application.
.IP *
Its size is managed automatically by observing resize events from the underlying terminal instance, and should not be set by the application.
.IP *
It is initially fully-damaged after construction, and will have a pending expose event waiting to occur.
.SH "RETURN VALUE"
If successful, \fBtickit_window_new_root\fP() returns a pointer to the new instance.
.SH "SEE ALSO"
.BR tickit_window_new (3),
.BR tickit_window_get_term (3),
.BR tickit_window_bind_event (3),
.BR tickit_window_expose (3),
.BR tickit_window (7),
.BR tickit (7)