About Us Documentation

Contact Site Map




Tk_FreeXId(3)         Tk Library Procedures                   4.0



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, cur- sor, 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 iden- tifiers 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_GetFontStruct, 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.


resource identifier Tk 1 Prepared by Ready-to-Run Software, Inc.


Email addresses listed on this site may  NOT be used for unsolicited commercial email.

Ready-to-Run Software, Inc Privacy Statement

Portions (c)Copyright, 1996-2005 by Ready-to-Run Software, Inc
(All rights reserved.)
212 Cedar Cove
Lansing, NY 14882
Phone: 607 533 UNIX (8649)
Fax: 607 533 4002

To return to the Ready-to-Run Software WinPak Table of contents please presshere