Provided by: tk8.4-doc_8.4.19-4_all bug

NAME

       Tk_FreeXId - make X resource identifier available for reuse

SYNOPSIS

       #include <tk.h>

       Tk_FreeXId(display, id)

ARGUMENTS

       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.
_________________________________________________________________

DESCRIPTION

       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
       corresponding Xlib free procedure, such as XFreePixmap.  If you don't 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.

KEYWORDS

       resource identifier