Tk_WindowId(3) Tk Library Procedures Tk_WindowId(3)
____________________________________________________________________________________________________________
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_InternalBorder-Right, Tk_InternalBorderRight,
Right, 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 parent is the token that was spec-ified specified
ified when tkwin was created, or NULL for main windows.
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 infor-mation information
mation 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 essential
tial that applications use Tk procedures like Tk_ResizeWindow instead of X procedures like XRe-sizeWindow, XResizeWindow,
sizeWindow, 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 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 isn't mapped.
Tk_IsTopLevel returns a non-zero value if tkwin is a top-level window (its X parent is the root win-dow window
dow 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 cor-respond correspond
respond 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_SetInternal-Border Tk_SetInternalBorder
Border 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(3)
|