Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tk_internatom(3tk) [opensolaris man page]

Tk_InternAtom(3TK)					       Tk Library Procedures						Tk_InternAtom(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_InternAtom, Tk_GetAtomName - manage cache of X atoms

SYNOPSIS

       #include <tk.h>

       Atom
       Tk_InternAtom(tkwin, name)

       CONST char *
       Tk_GetAtomName(tkwin, atom)

ARGUMENTS

       Tk_Window   tkwin    (in)      Token for window.  Used to map atom or name relative to a particular display.

       CONST char  *name    (in)      String name for which atom is desired.

       Atom	   atom     (in)      Atom for which corresponding string name is desired.
_________________________________________________________________

DESCRIPTION

       These  procedures  are  similar	to the Xlib procedures XInternAtom and XGetAtomName.  Tk_InternAtom returns the atom identifier associated
       with string given by name;  the atom identifier is only valid for the display associated with tkwin.   Tk_GetAtomName  returns  the  string
       associated  with  atom  on tkwin's display.  The string returned by Tk_GetAtomName is in Tk's storage:  the caller need not free this space
       when finished with the string, and the caller should not modify the contents of the returned string.  If there is no atom atom  on  tkwin's
       display, then Tk_GetAtomName returns the string ``?bad atom?''.

       Tk  caches  the information returned by Tk_InternAtom and Tk_GetAtomName so that future calls for the same information can be serviced from
       the cache without contacting the server.  Thus Tk_InternAtom and Tk_GetAtomName are generally much faster than their Xlib counterparts, and
       they should be used in place of the Xlib procedures.

KEYWORDS

       atom, cache, display

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk																Tk_InternAtom(3TK)

Check Out this Related Man Page

Tk_MapWindow(3TK)					       Tk Library Procedures						 Tk_MapWindow(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_MapWindow, Tk_UnmapWindow - map or unmap a window

SYNOPSIS

       #include <tk.h>

       Tk_Window
       Tk_MapWindow(tkwin)

       Tk_UnmapWindow(tkwin)

ARGUMENTS

       Tk_Window   tkwin    (in)      Token for window.
_________________________________________________________________

DESCRIPTION

       These  procedures  may  be used to map and unmap windows managed by Tk.	Tk_MapWindow maps the window given by tkwin, and also creates an X
       window corresponding to tkwin if it doesn't already exist.  See the Tk_CreateWindow manual entry for information on  deferred  window  cre-
       ation.  Tk_UnmapWindow unmaps tkwin's window from the screen.

       If tkwin is a child window (i.e. Tk_CreateWindow was used to create a child window), then event handlers interested in map and unmap events
       are invoked immediately.  If tkwin isn't an internal window, then the event handlers will be invoked later, after X has	seen  the  request
       and returned an event for it.

       These  procedures  should be used in place of the X procedures XMapWindow and XUnmapWindow, since they update Tk's local data structure for
       tkwin.  Applications using Tk should not invoke XMapWindow and XUnmapWindow directly.

KEYWORDS

       map, unmap, window

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk																 Tk_MapWindow(3TK)
Man Page