Home Man
Today's Posts

Linux & Unix Commands - Search Man Pages

CentOS 7.0 - man page for tk_freexid (centos section 3)

Tk_FreeXId(3)			      Tk Library Procedures			    Tk_FreeXId(3)


       Tk_FreeXId - make X resource identifier available for reuse

       #include <tk.h>

       Tk_FreeXId(display, id)

       Display *display (in)	      Display for which id was allocated.

       XID id (in)		      Identifier  of  X  resource  (window, font, pixmap, cursor,
				      graphics context, or colormap) that is no longer in use.

       The default allocator for resource identifiers provided by Xlib is very simple-minded  and
       does  not allow resource identifiers to be re-used.  If a long-running application reaches
       the end of the resource id space, it will generate an X	protocol  error  and  crash.   Tk
       replaces  the  default id allocator with its own allocator, which allows identifiers to be
       reused.	In order for this to work, Tk_FreeXId must be called to tell the allocator  about
       resources  that	have  been  freed.  Tk automatically calls Tk_FreeXId whenever it frees a
       resource, so if you use procedures like Tk_GetFont, Tk_GetGC, and  Tk_GetPixmap	then  you
       need  not  call	Tk_FreeXId.   However,	if you allocate resources directly from Xlib, for
       example by calling XCreatePixmap, then you should call Tk_FreeXId when you call the corre-
       sponding Xlib free procedure, such as XFreePixmap.  If you do not call Tk_FreeXId then the
       resource identifier will be lost, which could cause problems if the application runs  long
       enough to lose all of the available identifiers.

       resource identifier

Tk					       4.0				    Tk_FreeXId(3)

All times are GMT -4. The time now is 09:08 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
Show Password