TIX(3)							       Tix Built-In Commands							    TIX(3)

NAME

       tixGrid	-  Create  and	manipulate  Tix  Grid  widgets	-background    -borderWidth   -cursor -font	-foreground    -height -highlight-
       Color	 -highlightThickness -relief -selectBackground	 -selectForeground   -width -xScrollCommand	-yScrollCommand

WIDGET-SPECIFIC OPTIONS
       [-editdonecmd editDoneCmd] If non-empty, gives a Tcl command to be executed when the user has  edited  grid  cell.  When  this  command	is
       called, it is passed with two additional parameters: x y, where (x,y) is the location of the cell that has just been edited.  [-editnotify-
       cmd editNotifyCmd] If non-empty, gives a Tcl command to be executed when the user tries to edit a grid cell. When this command  is  called,
       it  is  passed  with  two additional parameters: x y, where (x,y,) is the location of the cell. This command should return a boolean value:
       true indicates that the cells is editable and false otherwise.  [-formatcmd formatCmd] If non-empty, gives a Tcl  command  to  be  executed
       when  the grid cells need to be formatted on the screen. Normally, this command calls the format widget command (see below). When this com-
       mand is called, it is passed with five additional parameters: type x1 y1 x2 y2. type gives the logical type of the region in the  grid.	It
       may  be	one  of the following. x-region: the horizontal margin; y-region: the vertical margin; s-region, the area where the the horizontal
       and vertical margins are joined; main: all the cells that do not fall into the above three types.  x1 y1 x2 y2  gives  the  extent  of  the
       region  that  needs formatting.	[-leftmargin leftMargin] In the number of cells, gives the width of vertical margin. A zero indicates that
       no vertical should be drawn.  [-selectmode selectMode] Specifies one of several styles for manipulating the selection.  The  value  of  the
       option  may  be arbitrary, but the default bindings expect it to be either single, browse, multiple, or extended; the default value is sin-
       gle.  [-selectunit selectUnit] Specifies the selection unit. Valid values are cell, column or row.  [-topmargin topMargin] In the number of
       cells, gives the height of horizontal margin. A zero indicates that no horizontal should be drawn.

DESCRIPTION

       The  tixGrid  command  creates  a  new  window  (given  by  the pathName argument) and makes it into a tixGrid widget.  Additional options,
       described above, may be specified on the command line or in the option database to configure aspects of the tixGrid widget such as its cur-
       sor and relief.

       A  Grid	widget displays its contents in a two dimensional grid of cells. Each cell may contain one Tix display item, which may be in text,
       graphics or other formats. See the tixDisplayStyle manual page for more information about Tix display items. Individual cells, or groups of
       cells, can be formatted with a wide range of attributes, such as its color, relief and border.

WIDGET COMMAND

       The  tixGrid  command creates a new Tcl command whose name is the same as the path name of the tixGrid widget's window. This command may be
       used to invoke various operations on the widget. It has the following general form:
	      pathName option ?arg arg ...?
       PathName is the name of the command, which is the same as the tixGrid widget's path name. Option and the args determine the exact  behavior
       of the command. The following commands are possible for tixGrid widgets:

       pathName anchor option ?args ...?
	      Manipulates the anchor cell of the tixGrid widget. The anchor cell is the end of the selection that is fixed while the user is drag-
	      ging out a selection with the mouse.

       pathName bdtype
	      TODO place holder

       pathName cget option
	      Returns the current value of the configuration option given by option. Option may have any of the values	accepted  by  the  tixGrid
	      command.

       pathName configure ?option? ?value option value ...?
	      Query  or modify the configuration options of the widget.  If no option is specified, returns a list describing all of the available
	      options for pathName (see Tk_ConfigureInfo(n) for information on the format of this list.) If option is  specified  with	no  value,
	      then  the  command  returns  a list describing the one named option (this list will be identical to the corresponding sublist of the
	      value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given wid-
	      get  option(s)  to  have	the  given  value(s);  in this case the command returns an empty string. Option may have any of the values
	      accepted by the tixGrid command.

       pathName delete dim from ?to?
	      Dim may be row or column. If to is not given, deletes a single row (or column) at the position from. If to  is  given,  deletes  the
	      range of rows (or columns) from position from through to.

       pathName edit apply
	      If any cell is being edited, de-highlight the cell and applies the changes.

       pathName edit set x y
	      Highlights the cell at (x,y) for editing, if the -editnotify command returns true for this cell.

       pathName entrycget x y option
	      Returns  the  current  value  of	the  configuration  option given by option of the cell at (x,y). Option may have any of the values
	      accepted by the set widget command.

       pathName entryconfigure x y ?option? ?value option value ...?
	      Query or modify the configuration options of the cell at (x,y).  If no option is specified, returns a list  describing  all  of  the
	      available options for the cell (see Tk_ConfigureInfo(n) for information on the format of this list.)  If option is specified with no
	      value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist	of
	      the  value returned if no option is specified.) If one or more option-value pairs are specified, then the command modifies the given
	      widget option(s) to have the given value(s); in this case the command returns an empty string.  Option may have any  of  the  values
	      accepted by the set widget command.

       pathName format
	      TODO place holder

       pathName index
	      TODO place holder

       pathName move dim from to offset
	      Dim  may	be row or column. Moves the the range of rows (or columns) from position from through to by the distance indicated by off-
	      set. For example, move row 2 4 1 moves the rows 2,3,4 to rows 3,4,5.

       pathName set x y ?-itemtype type? ?option value...?
	      Creates a new display item at the cell at (x,y). The optional -itemtype parameter gives the type of the display item. An	additional
	      list  of option-value pairs specify options of the display item. If a display item already exists at this cell, the old item will be
	      deleted automatically.

       pathName size dim index ?option value ...?
	      Queries or sets the size of the row or column given by dim and index. Dim may be row or column.  Index may be any non-negative inte-
	      ger  that gives the position of a given row (or column). Index can also be the string default; in this case, this command queries or
	      sets the default size of all rows (or columns).

       When no option-value pair is given, this command returns a list containing the current size setting of the  given  row  (or  column).  When
       option-value  pairs  are  given, the corresponding options of the size setting of the given row are changed. Option may be one of the foll-
       wing:

	      -pad0 pixels
		     Specifies the paddings to the left or a column or the top of a row.

	      -pad1 pixels
		     Specifies the paddings to the right or a column or the bottom of a row.

	      -size val
		     Specifies the width of a column or the height of a row. Val may be: auto -- the width of the column is  set  the  the  widest
		     cell in the column; a valid Tk screen distance unit (see Tk_GetPixels(n)); or a real number following by the word chars (e.g.
		     3.4chars) that sets the width of the column to the given number of characters.

       pathName unset x y
	      Clears the cell at (x,y) by removing its display item.

       pathName xview
	      TODO place holder

       pathName yview
	      TODO place holder

KEYWORDS

       grid, spread sheet, table

Tix									4.1								    TIX(3)