Tk_X(3tk)

______________________________________________________________________________

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   -  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)

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 par-
       ent is the token that was specified when tkwin was created, or NULL for
       main windows.

       Tk_Display  returns a pointer to the Xlib display structure correspond-
       ing 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  essen-
       tial  that  applications use Tk procedures like Tk_ResizeWindow instead
       of X procedures like XResizeWindow, so that Tk can keep its data struc-
       tures 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 is not a free-stand-
       ing window, but rather is embedded in some other application.

       Tk_IsMapped  returns  a  non-zero  value if tkwin is mapped and zero if
       tkwin isn't 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 isn't
       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_Geome-
       tryRequest for tkwin.

       Tk_MinReqWidth and Tk_MinReqHeight return information  about  the  win-
       dow'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, identi-
       fier, mapped, requested size, screen, top-level, visual, width, window,
       x, y

Tk                                    8.4                       Tk_WindowId(3)