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)
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
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)
Man(1) output converted with
man2html
|