winfo(n)		     Ck Built-In Commands		      winfo(n)



______________________________________________________________________________

NAME
       winfo - Return window-related information

SYNOPSIS
       winfo option ?arg arg ...?
_________________________________________________________________


DESCRIPTION
       The winfo command is used to retrieve information about windows managed
       by Ck.  It can take any of a number of different	 forms,	 depending  on
       the option argument.  The legal forms are:

       winfo children window
	      Returns  a list containing the path names of all the children of
	      window.  Top-level windows are returned  as  children  of	 their
	      logical parents.

       winfo class window
	      Returns the class name for window.

       winfo containing rootX rootY
	      Returns  the path name for the window containing the point given
	      by rootX and rootY.  RootX and rootY  are	 specified  as	cursor
	      position in the coordinate system of the terminal.  If no window
	      in this application contains the point then an empty  string  is
	      returned.	  In  selecting	 the  containing  window, children are
	      given higher priority than parents and among siblings the	 high-
	      est one in the stacking order is chosen.

       winfo depth window
	      Returns a decimal string giving the depth of window. 1 means the
	      terminal's screen is monochrome. Any number higher than 1	 means
	      that the terminal supports colors.

       winfo exists window
	      Returns  1  if  there exists a window named window, 0 if no such
	      window exists.

       winfo geometry window
	      Returns the geometry for window, in the  form  widthxheight+x+y.
	      All dimensions are in terminal coordinates.

       winfo height window
	      Returns  a  decimal  string  giving  window's height in terminal
	      lines.  When a window is first created its  height  will	be  1;
	      the  height  will eventually be changed by a geometry manager to
	      fulfill the window's needs.  If you need the true height immedi-
	      ately after creating a widget, invoke update to force the geome-
	      try manager to arrange it, or use winfo  reqheight  to  get  the
	      window's requested height instead of its actual height.

       winfo ismapped window
	      Returns 1 if window is currently mapped, 0 otherwise.

       winfo manager window
	      Returns  the  name of the geometry manager currently responsible
	      for window, or an empty string if window isn't  managed  by  any
	      geometry	manager.  The name is usually the name of the Tcl com-
	      mand for the geometry manager, such as pack or place.

       winfo name window
	      Returns window's name (i.e.  its	name  within  its  parent,  as
	      opposed  to  its full path name).	 The command winfo name . will
	      return the name of the application.

       winfo parent window
	      Returns the path name of window's parent, or an empty string  if
	      window is the main window of the application.

       winfo reqheight window
	      Returns  a  decimal  string giving window's requested height, in
	      lines.  This is the value used by window's geometry  manager  to
	      compute its geometry.

       winfo reqwidth window
	      Returns  a  decimal  string  giving window's requested width, in
	      columns.	This is the value used by window's geometry manager to
	      compute its geometry.

       winfo rootx window
	      Returns  a  decimal  string giving the x-coordinate, in the root
	      window of the screen, of the upper-left corner of window's  bor-
	      der (or window if it has no border).

       winfo rooty window
	      Returns  a  decimal  string giving the y-coordinate, in the root
	      window of the screen, of the upper-left corner of window's  bor-
	      der (or window if it has no border).

       winfo screenheight window
	      Returns  a decimal string giving the height of window's terminal
	      screen, in lines.

       winfo screenwidth window
	      Returns a decimal string giving the width of  window's  terminal
	      screen, in columns.

       winfo toplevel window
	      Returns the path name of the top-level window containing window.

       winfo width window
	      Returns a decimal string giving window's width in columns.  When
	      a window is first created its width will be 1;  the  width  will
	      eventually  be changed by a geometry manager to fulfill the win-
	      dow's needs.  If you need the true width immediately after  cre-
	      ating  a	widget, invoke update to force the geometry manager to
	      arrange it, or use winfo reqwidth to get the window's  requested
	      width instead of its actual width.

       winfo x window
	      Returns  a  decimal  string giving the x-coordinate, in window's
	      parent, of the upper-left corner of window's border  (or	window
	      if it has no border).

       winfo y window
	      Returns  a  decimal  string giving the y-coordinate, in window's
	      parent, of the upper-left corner of window's border  (or	window
	      if it has no border).


KEYWORDS
       children,  class,  geometry,  height,  identifier, information, mapped,
       parent, path name, screen, terminal, width, window



Ck				      8.0			      winfo(n)
