Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TICKIT_WINDOW_NEW_ROOT(3)  Library Functions Manual  TICKIT_WINDOW_NEW_ROOT(3)

NAME
       tickit_window_new_root -	create a new toplevel root window

SYNOPSIS
       #include	<tickit.h>

       TickitWindow *tickit_window_new_root(TickitTerm *term);

       Link with -ltickit.

DEPRECATED
       This function is	deprecated and should not be used in new programs. In-
       stead,  obtain  the  root  window  from the toplevel Tickit instance by
       calling tickit_get_rootwin(3).

DESCRIPTION
       tickit_window_new_root()	creates	a new toplevel	TickitWindow  instance
       to  represent the drawing area on the given terminal instance. The ter-
       minal instance is stored	by the window itself, and is used for flushing
       the TickitRenderBuffer 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.

       The root	window behaves similar to other	windows	 within	 the  applica-
       tion, with the following	differences:

       *      Its position remains fixed at zero, and should not be set	by the
	      application.

       *      Its  size	 is  managed  automatically by observing resize	events
	      from the underlying terminal instance, and should	not be set  by
	      the application.

       *      It  is initially fully-damaged after construction, and will have
	      a	pending	expose event waiting to	occur.

RETURN VALUE
       If successful, tickit_window_new_root() returns a pointer  to  the  new
       instance.

SEE ALSO
       tickit_window_new(3),	   tickit_window_get_term(3),	   tickit_win-
       dow_bind_event(3), tickit_window_expose(3), tickit_window(7), tickit(7)

						     TICKIT_WINDOW_NEW_ROOT(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tickit_window_new_root&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help