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
CONST char *
Tk_Window tkwin (in) Token for window.
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
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-
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.
attributes, colormap, depth, display, height, geometry manager, identi-
fier, mapped, requested size, screen, top-level, visual, width, window,
Tk 8.4 Tk_WindowId(3)
Man(1) output converted with