MAN sezione 3 - Torna all'indice

Contents

• NAME
• SYNOPSIS
• ARGUMENTS
• DESCRIPTION
• KEYWORDS

_________________________________________________________________

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, cur­
                                      sor,  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_Get­
       FontStruct,  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
       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


Tk                             4.0                              1