Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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_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 par-
       ent 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  correspond-
       ing  to	tkwin.	Tk_DisplayName returns an ASCII	string identifying tk-
       win'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 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 tk-
       win 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 re-
       quested 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 vis-
       ual characteristics of a	window.	 Tk_Visual returns the visual type for
       the  window, Tk_Depth returns the number	of bits	per pixel, and Tk_Col-
       ormap returns the current colormap for the window.  The visual  charac-
       teristics  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)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Tk_Attributes.tk86&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help