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

  
 
  

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 terminal in-
     stance is stored by the window itself, and is used for flushing  the  Tick-
     itRenderBuffer  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 application,
     with the following differences:

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

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

     *	    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 in-
     stance.

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.1.quarterly>

home | help