NAME

       Tk_WindowId,  Tk_Parent,  Tk_Display,  Tk_DisplayName,  Tk_ScreenNumber, Tk_Screen, Tk_X, Tk_Y, Tk_Width,
       Tk_Height,  Tk_Changes,  Tk_Attributes,  Tk_IsContainer,   Tk_IsEmbedded,   Tk_IsMapped,   Tk_IsTopLevel,
       Tk_ReqWidth,       Tk_ReqHeight,       Tk_MinReqWidth,       Tk_MinReqHeight,      Tk_InternalBorderLeft,
       Tk_InternalBorderRight, Tk_InternalBorderTop, Tk_InternalBorderBottom, Tk_Visual, Tk_Depth,  Tk_Colormap,
       Tk_Interp  - retrieve information from Tk's local data structure

SYNOPSIS

       #include <tk.h>

       Window
       Tk_WindowId(tkwin)

       Tk_Window
       Tk_Parent(tkwin)

       Display *
       Tk_Display(tkwin)

       const char *
       Tk_DisplayName(tkwin)

       int
       Tk_ScreenNumber(tkwin)

       Screen *
       Tk_Screen(tkwin)

       int
       Tk_X(tkwin)

       int
       Tk_Y(tkwin)

       int
       Tk_Width(tkwin)

       int
       Tk_Height(tkwin)

       XWindowChanges *
       Tk_Changes(tkwin)

       XSetWindowAttributes *
       Tk_Attributes(tkwin)

       int
       Tk_IsContainer(tkwin)

       int
       Tk_IsEmbedded(tkwin)

       int
       Tk_IsMapped(tkwin)

       int
       Tk_IsTopLevel(tkwin)

       int
       Tk_ReqWidth(tkwin)

       int
       Tk_ReqHeight(tkwin)

       int
       Tk_MinReqWidth(tkwin)

       int
       Tk_MinReqHeight(tkwin)

       int
       Tk_InternalBorderLeft(tkwin)

       int
       Tk_InternalBorderRight(tkwin)

       int
       Tk_InternalBorderTop(tkwin)

       int
       Tk_InternalBorderBottom(tkwin)

       Visual *
       Tk_Visual(tkwin)

       int
       Tk_Depth(tkwin)

       Colormap
       Tk_Colormap(tkwin)

       Tcl_Interp *
       Tk_Interp(tkwin)

ARGUMENTS

       Tk_Window tkwin (in)          Token for window.
________________________________________________________________________________________________________________

DESCRIPTION

       Tk_WindowId  and  the  other  names  listed  above are all macros that return fields from Tk's local data
       structure for tkwin.  None of these macros requires any interaction with  the  server;   it  is  safe  to
       assume that all are fast.

       Tk_WindowId returns the X identifier for tkwin, or NULL if no X window has been created for tkwin yet.

       Tk_Parent returns Tk's token for the logical parent of tkwin.  The parent is the token that was specified
       when tkwin was created, or NULL for main windows.

       Tk_Interp returns the Tcl interpreter associated with a tkwin or NULL if there is an error.

       Tk_Display  returns  a  pointer  to  the  Xlib  display structure corresponding to tkwin.  Tk_DisplayName
       returns an ASCII string identifying tkwin's display.  Tk_ScreenNumber returns the index of tkwin's screen
       among all  the  screens  of  tkwin's  display.   Tk_Screen  returns  a  pointer  to  the  Xlib  structure
       corresponding to tkwin's screen.

       Tk_X,  Tk_Y,  Tk_Width, and Tk_Height return information about tkwin's location within its parent and its
       size.  The location information refers to the upper-left pixel in the window, or its border if  there  is
       one.   The  width  and  height  information  refers to the interior size of the window, not including any
       border.  Tk_Changes returns a pointer to a structure containing all of the above information plus  a  few
       other fields.  Tk_Attributes returns a pointer to an XSetWindowAttributes structure describing all of the
       attributes of the tkwin's window, such as background pixmap, event mask, and so on (Tk keeps track of all
       this  information  as  it is changed by the application).  Note: it is essential that applications use Tk
       procedures like Tk_ResizeWindow instead of X procedures like XResizeWindow, so that Tk can keep its  data
       structures up-to-date.

       Tk_IsContainer  returns  a non-zero value if tkwin is a container, and that some other application may be
       embedding itself inside tkwin.

       Tk_IsEmbedded returns a non-zero value if tkwin is not a free-standing window, but rather is embedded  in
       some other application.

       Tk_IsMapped returns a non-zero value if tkwin is mapped and zero if tkwin is not mapped.

       Tk_IsTopLevel returns a non-zero value if tkwin is a top-level window (its X parent is the root window of
       the screen) and zero if tkwin is not a top-level window.

       Tk_ReqWidth  and  Tk_ReqHeight  return  information  about  the  window's  requested  size.  These values
       correspond to the last call to Tk_GeometryRequest for tkwin.

       Tk_MinReqWidth and Tk_MinReqHeight return information about the window's minimum requested  size.   These
       values correspond to the last call to Tk_SetMinimumRequestSize for tkwin.

       Tk_InternalBorderLeft,  Tk_InternalBorderRight,  Tk_InternalBorderTop  and Tk_InternalBorderBottom return
       the width of one side of the internal border that has been requested for  tkwin,  or  0  if  no  internal
       border  was  requested.   The  return  value  is  simply the last value passed to Tk_SetInternalBorder or
       Tk_SetInternalBorderEx for tkwin.

       Tk_Visual, Tk_Depth, and Tk_Colormap return information about the visual  characteristics  of  a  window.
       Tk_Visual  returns  the  visual  type  for the window, Tk_Depth returns the number of bits per pixel, and
       Tk_Colormap returns the current colormap for the window.  The visual  characteristics  are  normally  set
       from the defaults for the window's screen, but they may be overridden by calling Tk_SetWindowVisual.

KEYWORDS

       attributes,  colormap,  depth,  display,  height,  geometry  manager, identifier, mapped, requested size,
       screen, top-level, visual, width, window, x, y

Tk                                                     8.4                                      Tk_WindowId(3tk)