home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _27482f9f19ebb47ef664dca60d1dbaf0 < prev    next >
Text File  |  2000-03-23  |  26KB  |  501 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Tk::TixGrid - Create and manipulate Tix Grid widgets</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Tk::TixGrid - Create and manipulate Tix Grid widgets</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#standard options">STANDARD OPTIONS</A></LI>
  25.     <LI><A HREF="#widgetspecific options">WIDGET-SPECIFIC OPTIONS</A></LI>
  26.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  27.     <LI><A HREF="#widget methods">WIDGET METHODS</A></LI>
  28.     <LI><A HREF="#bindings">BINDINGS</A></LI>
  29.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  30.     <LI><A HREF="#bugs">BUGS</A></LI>
  31.     <LI><A HREF="#keywords">KEYWORDS</A></LI>
  32. </UL>
  33. <!-- INDEX END -->
  34.  
  35. <HR>
  36. <P>
  37. <H1><A NAME="name">NAME</A></H1>
  38. <P>Tk::TixGrid - Create and manipulate Tix Grid widgets</P>
  39. <P>
  40. <HR>
  41. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  42. <UL>
  43. <LI>Linux</LI>
  44. <LI>Solaris</LI>
  45. <LI>Windows</LI>
  46. </UL>
  47. <HR>
  48. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  49. <P>    <EM>$tixgrid</EM> = <EM>$parent</EM>-><STRONG>TixGrid</STRONG>?(<EM>options</EM>)?;</P>
  50. <PRE>
  51.     The port of C code and bindings is done but needs
  52.     debugging.  THERE ARE KNOWN BUGS. Work in progress ...</PRE>
  53. <P>
  54. <HR>
  55. <H1><A NAME="standard options">STANDARD OPTIONS</A></H1>
  56. <P><TABLE CELLSPACING=0 CELLPADDING=0><TR><TD><STRONG>-background</STRONG>
  57. <TR><TD><TD><STRONG>-borderwidth</STRONG>
  58. <TR><TD><TD><STRONG>-cursor</STRONG>
  59. <TR><TD><TD><STRONG>-font</STRONG>
  60. <TR><TD><TD><STRONG>-foreground</STRONG>
  61. <TR><TD><TD><STRONG>-height</STRONG>
  62. <TR><TD><TD><STRONG>-highlightbackground</STRONG>
  63. <TR><TD><TD><STRONG>-highlightcolor</STRONG>
  64. <TR><TD><TD><STRONG>-highlightthickness</STRONG>
  65. <TR><TD><TD><STRONG>-padx</STRONG>
  66. <TR><TD><TD><STRONG>-pady</STRONG>
  67. <TR><TD><TD><STRONG>-relief</STRONG>
  68. <TR><TD><TD><STRONG>-selectbackground</STRONG>
  69. <TR><TD><TD><STRONG>-selectborderwidth</STRONG>
  70. <TR><TD><TD><STRONG>-selectforeground</STRONG>
  71. <TR><TD><TD><STRONG>-state</STRONG>
  72. <TR><TD><TD><STRONG>-takefocus</STRONG>
  73. <TR><TD><TD><STRONG>-width</STRONG>
  74. <TR><TD><TD><STRONG>-xscrollcommand</STRONG>
  75. <TR><TD><TD><STRONG>-yscrollcommand</STRONG></TABLE></P>
  76. <P>See <A HREF="../../../site/lib/Tk/options.html">the Tk::options manpage</A> for details of the standard options.</P>
  77. <P>
  78. <HR>
  79. <H1><A NAME="widgetspecific options">WIDGET-SPECIFIC OPTIONS</A></H1>
  80. <DL>
  81. <DT><STRONG><A NAME="item_Name%3A_browseCmd">Name:    <STRONG>browseCmd</STRONG></A></STRONG><BR>
  82. <DD>
  83. <DT><STRONG><A NAME="item_Class%3A_BrowseCmd">Class:    <STRONG>BrowseCmd</STRONG></A></STRONG><BR>
  84. <DD>
  85. <DT><STRONG><A NAME="item_Switch%3A_%2Dbrowsecmd">Switch:    <STRONG>-browsecmd</STRONG></A></STRONG><BR>
  86. <DD>
  87. ?docu here?  Not in configure output but used in bindings ??!!
  88. <P>If defined, gives a perl/Tk <A HREF="../../../site/lib/Tk/callbacks.html">callback</A>
  89. to be executed when the
  90. user browses a grid cell (This is normally the case when
  91. the user clicks on an entry).  When this callback is called, it is
  92. passed with two additional parameters: <EM>x</EM> <EM>y</EM>, where (<EM>x</EM>,<EM>y</EM>)
  93. is the location of the cell that has just been clicked.</P>
  94. <P></P>
  95. <DT><STRONG><A NAME="item_Name%3A_Command">Name:    <STRONG>Command</STRONG></A></STRONG><BR>
  96. <DD>
  97. <DT><STRONG><A NAME="item_Class%3A_Command">Class:    <STRONG>Command</STRONG></A></STRONG><BR>
  98. <DD>
  99. <DT><STRONG><A NAME="item_Switch%3A_%2Dcommand">Switch:    <STRONG>-command</STRONG></A></STRONG><BR>
  100. <DD>
  101. ?docu here?  Not in configure output but used in bindings ??!!
  102. <P></P>
  103. <DT><STRONG><A NAME="item_Name%3A_editDoneCmd">Name:    <STRONG>editDoneCmd</STRONG></A></STRONG><BR>
  104. <DD>
  105. <DT><STRONG><A NAME="item_Class%3A_EditDoneCmd">Class:    <STRONG>EditDoneCmd</STRONG></A></STRONG><BR>
  106. <DD>
  107. <DT><STRONG><A NAME="item_Switch%3A_%2Deditdonecmd">Switch:    <STRONG>-editdonecmd</STRONG></A></STRONG><BR>
  108. <DD>
  109. If defined, gives a perl/Tk <A HREF="../../../site/lib/Tk/callbacks.html">callback</A>
  110. to be executed when the
  111. user has edited grid cell. When this callback is called, it is
  112. passed with two additional parameters: <EM>x</EM> <EM>y</EM>, where (<EM>x</EM>,<EM>y</EM>)
  113. is the location of the cell that has just been edited.
  114. <P></P>
  115. <DT><STRONG><A NAME="item_Name%3A_editNotifyCmd">Name:    <STRONG>editNotifyCmd</STRONG></A></STRONG><BR>
  116. <DD>
  117. <DT><STRONG><A NAME="item_Class%3A_EditNotifyCmd">Class:    <STRONG>EditNotifyCmd</STRONG></A></STRONG><BR>
  118. <DD>
  119. <DT><STRONG><A NAME="item_Switch%3A_%2Deditnotifycmd">Switch:    <STRONG>-editnotifycmd</STRONG></A></STRONG><BR>
  120. <DD>
  121. If defined gives a perl/Tk <A HREF="../../../site/lib/Tk/callbacks.html">callback</A>
  122. to be executed when the user tries to edit a grid cell.
  123. When this callback is called, it is passed with two additional
  124. parameters: <EM>x</EM> <EM>y</EM>, where (<EM>x</EM>,<EM>y</EM>,) is the location
  125. of the cell. This callback should return a boolean value: <STRONG>true</STRONG>
  126. indicates that the cell is editable and <STRONG>false</STRONG> otherwise.
  127. <P></P>
  128. <DT><STRONG><A NAME="item_Name%3A_FloatingCols">Name:    <STRONG>FloatingCols</STRONG></A></STRONG><BR>
  129. <DD>
  130. <DT><STRONG><A NAME="item_Class%3A_floatingCols">Class:    <STRONG>floatingCols</STRONG></A></STRONG><BR>
  131. <DD>
  132. <DT><STRONG><A NAME="item_Switch%3A_%2Dfloatingcols">Switch:    <STRONG>-floatingcols</STRONG></A></STRONG><BR>
  133. <DD>
  134. Defines the number of columns that fixed when the widget
  135. is horizontally scrolled.  These <CODE>column(s)</CODE>
  136. can be used as <CODE>label(s)</CODE> for the column(s).  The floating <CODE>column(s)</CODE>
  137. can be configured in the <STRONG>-formatcmd</STRONG> callback with the
  138. <STRONG>formatBorder</STRONG> method.  The default value is 0.
  139. <P></P>
  140. <DT><STRONG><A NAME="item_Name%3A_FloatingRows">Name:    <STRONG>FloatingRows</STRONG></A></STRONG><BR>
  141. <DD>
  142. <DT><STRONG><A NAME="item_Class%3A_floatingRows">Class:    <STRONG>floatingRows</STRONG></A></STRONG><BR>
  143. <DD>
  144. <DT><STRONG><A NAME="item_Switch%3A_%2Dfloatingrows">Switch:    <STRONG>-floatingrows</STRONG></A></STRONG><BR>
  145. <DD>
  146. Defines the number of rows that are fixed when the widget
  147. is vertically scrolled.  These <CODE>row(s)</CODE>
  148. can be used as <CODE>label(s)</CODE> for the row(s).  The floating <CODE>row(s)</CODE>
  149. can be configured in the <STRONG>-formatcmd</STRONG> callback with the
  150. <STRONG>formatBorder</STRONG> method.  The default value is 0.
  151. <P></P>
  152. <DT><STRONG><A NAME="item_Name%3A_formatCmd">Name:    <STRONG>formatCmd</STRONG></A></STRONG><BR>
  153. <DD>
  154. <DT><STRONG><A NAME="item_Class%3A_FormatCmd">Class:    <STRONG>FormatCmd</STRONG></A></STRONG><BR>
  155. <DD>
  156. <DT><STRONG><A NAME="item_Switch%3A_%2Dformatcmd">Switch:    <STRONG>-formatcmd</STRONG></A></STRONG><BR>
  157. <DD>
  158. If defined, gives a perl/Tk <A HREF="../../../site/lib/Tk/callbacks.html">callback</A> to be
  159. executed when the grid cells need to be formatted on the screen.
  160. Normally, this callback calls the <STRONG>format</STRONG> method (see below).
  161. When this callback is called, it is passed with five additional
  162. parameters: <EM>type</EM> <EM>x1</EM> <EM>y1</EM> <EM>x2</EM> <EM>y2</EM>. <EM>type</EM> gives the
  163. logical type of the region in the grid. It may be one of the
  164. following.
  165. <DL>
  166. <DT><STRONG><A NAME="item_x%2Dregion"><STRONG>x-region</STRONG></A></STRONG><BR>
  167. <DD>
  168. the horizontal margin
  169. <P></P>
  170. <DT><STRONG><A NAME="item_y%2Dregion"><STRONG>y-region</STRONG></A></STRONG><BR>
  171. <DD>
  172. the vertical margin
  173. <P></P>
  174. <DT><STRONG><A NAME="item_s%2Dregion"><STRONG>s-region</STRONG></A></STRONG><BR>
  175. <DD>
  176. the area where the horizontal and vertical margins are joined
  177. <P></P>
  178. <DT><STRONG><A NAME="item_main"><STRONG>main</STRONG></A></STRONG><BR>
  179. <DD>
  180. all the cells that do not fall into the above three types
  181. <P></P></DL>
  182. <P><EM>x1</EM> <EM>y1</EM> <EM>x2</EM> <EM>y2</EM> gives the extent of the region that needs
  183. formatting.</P>
  184. <DT><STRONG><A NAME="item_Name%3A_leftMargin">Name:    <STRONG>leftMargin</STRONG></A></STRONG><BR>
  185. <DD>
  186. <DT><STRONG><A NAME="item_Class%3A_LeftMargin">Class:    <STRONG>LeftMargin</STRONG></A></STRONG><BR>
  187. <DD>
  188. <DT><STRONG><A NAME="item_Switch%3A_%2Dleftmargin">Switch:    <STRONG>-leftmargin</STRONG></A></STRONG><BR>
  189. <DD>
  190. In the number of cells, gives the width of vertical margin.
  191. A zero indicates that no vertical should be drawn.
  192. <P></P>
  193. <DT><STRONG><A NAME="item_Name%3A_itemType">Name:    <STRONG>itemType</STRONG></A></STRONG><BR>
  194. <DD>
  195. <DT><STRONG><A NAME="item_Class%3A_ItemType">Class:    <STRONG>ItemType</STRONG></A></STRONG><BR>
  196. <DD>
  197. <DT><STRONG><A NAME="item_Switch%3A_%2Ditemtype">Switch:    <STRONG>-itemtype</STRONG></A></STRONG><BR>
  198. <DD>
  199. ?docu here?
  200. <P></P>
  201. <DT><STRONG><A NAME="item_Name%3A_selectMode">Name:    <STRONG>selectMode</STRONG></A></STRONG><BR>
  202. <DD>
  203. <DT><STRONG><A NAME="item_Class%3A_SelectMode">Class:    <STRONG>SelectMode</STRONG></A></STRONG><BR>
  204. <DD>
  205. <DT><STRONG><A NAME="item_Switch%3A_%2Dselectmode">Switch:    <STRONG>-selectmode</STRONG></A></STRONG><BR>
  206. <DD>
  207. Specifies one of several styles for manipulating the selection.
  208. The value of the option may be arbitrary, but the default bindings
  209. expect it to be either <STRONG>single</STRONG>, <STRONG>browse</STRONG>, <STRONG>multiple</STRONG>, or <STRONG>extended</STRONG>;
  210. the default value is <STRONG>single</STRONG>.
  211. <P></P>
  212. <DT><STRONG><A NAME="item_Name%3A_selectUnit">Name:    <STRONG>selectUnit</STRONG></A></STRONG><BR>
  213. <DD>
  214. <DT><STRONG><A NAME="item_Class%3A_SelectUnit">Class:    <STRONG>SelectUnit</STRONG></A></STRONG><BR>
  215. <DD>
  216. <DT><STRONG><A NAME="item_Switch%3A_%2Dselectunit">Switch:    <STRONG>-selectunit</STRONG></A></STRONG><BR>
  217. <DD>
  218. Specifies the selection unit. Valid values are <STRONG>cell</STRONG>, <STRONG>column</STRONG> or <STRONG>row</STRONG>.
  219. <P></P>
  220. <DT><STRONG><A NAME="item_Name%3A_sizeCmd">Name:    <STRONG>sizeCmd</STRONG></A></STRONG><BR>
  221. <DD>
  222. <DT><STRONG><A NAME="item_Class%3A_SizeCmd">Class:    <STRONG>SizeCmd</STRONG></A></STRONG><BR>
  223. <DD>
  224. <DT><STRONG><A NAME="item_Switch%3A_%2Dsizecmd">Switch:    <STRONG>-sizecmd</STRONG></A></STRONG><BR>
  225. <DD>
  226. ?docu here?
  227. <P></P>
  228. <DT><STRONG><A NAME="item_Name%3A_topMargin">Name:    <STRONG>topMargin</STRONG></A></STRONG><BR>
  229. <DD>
  230. <DT><STRONG><A NAME="item_Class%3A_TopMargin">Class:    <STRONG>TopMargin</STRONG></A></STRONG><BR>
  231. <DD>
  232. <DT><STRONG><A NAME="item_Switch%3A_%2Dtopmargin">Switch:    <STRONG>-topmargin</STRONG></A></STRONG><BR>
  233. <DD>
  234. In the number of cells, gives the height of horizontal margin.
  235. A zero indicates that no horizontal should be drawn.
  236. <P></P></DL>
  237. <P>
  238. <HR>
  239. <H1><A NAME="description">DESCRIPTION</A></H1>
  240. <P>The <STRONG>TixGrid</STRONG> method creates a TixGrid new window and returns a
  241. blessed reference of this TixGrid widget.
  242. Additional options,
  243. described above, may be specified on the command line or in the
  244. option database to configure aspects of the <STRONG>TixGrid</STRONG> widget
  245. such as its cursor and relief.</P>
  246. <P>A Grid widget displays its contents in a two dimensional grid of cells.
  247. Each cell may contain one Tix display item, which may be in text,
  248. graphics or other formats. See <A HREF="../../../site/lib/Tk/DItem.html">the Tk::DItem manpage</A> for more information
  249. about Tix display items. Individual cells, or groups of cells,
  250. can be formatted with a wide range of attributes, such as its color,
  251. relief and border.</P>
  252. <P>
  253. <HR>
  254. <H1><A NAME="widget methods">WIDGET METHODS</A></H1>
  255. <P>The <STRONG>TixGrid</STRONG> method creates a TixGrid widget and returns a blessed
  256. reference of this TixGrid widget.  This reference may be used to
  257. invoke various operations on the widget.  It has the following general
  258. form:</P>
  259. <P>    <EM>$tixgrid</EM>-><STRONG>method</STRONG>?(<EM>arg, arg, ...</EM>)?</P>
  260. <P><EM>arg</EM>s determine the exact behavior of the method. The following
  261. methods are possible for <STRONG>TixGrid</STRONG> widgets:</P>
  262. <DL>
  263. <DT><STRONG><A NAME="item_anchor"><EM>$tixgrid</EM>-><STRONG>anchor</STRONG>(<EM>action</EM>, <EM>x</EM>, <EM>y</EM>)</A></STRONG><BR>
  264. <DD>
  265. <DT><STRONG><A NAME="item_anchorAction"><EM>$tixgrid</EM>-><STRONG>anchor</STRONG><EM>Action</EM>(<EM>x</EM>, <EM>y</EM>)</A></STRONG><BR>
  266. <DD>
  267. Manipulates the <STRONG>anchor cell</STRONG> of the <STRONG>TixGrid</STRONG> widget.
  268. The anchor cell is the end of the selection that is fixed
  269. while the user is dragging out a selection with the mouse.
  270. <EM>Action</EM> can be <STRONG>clear</STRONG>, <STRONG>get</STRONG> or <STRONG>set</STRONG>.  If <EM>action</EM>
  271. is <STRONG>clear</STRONG>, <EM>x</EM> and <EM>y</EM> args are not accepted.
  272. <P></P>
  273. <DT><STRONG><A NAME="item_bdtype"><EM>$tixgrid</EM>-><STRONG>bdtype</STRONG>(<EM>x</EM>, <EM>y</EM> ?,<EM>xbdWidth</EM>, <EM>ybdWidth</EM>?)</A></STRONG><BR>
  274. <DD>
  275. ????
  276. <P></P>
  277. <DT><STRONG><A NAME="item_cget"><EM>$tixgrid</EM>-><STRONG>cget</STRONG>('<EM>-option</EM>')</A></STRONG><BR>
  278. <DD>
  279. Returns the current value of the configuration option given
  280. by <EM>-option</EM>. <EM>-option</EM> may have any of the values accepted
  281. by the <STRONG>TixGrid</STRONG> constructor method.
  282. <P></P>
  283. <DT><STRONG><A NAME="item_configure"><EM>$tixgrid</EM>-><STRONG>configure</STRONG>(?<EM>-option</EM>??=><EM>value</EM>, <EM>-option</EM>=><EM>value</EM>, <EM>...</EM>?)</A></STRONG><BR>
  284. <DD>
  285. Query or modify the configuration options of the widget.
  286. If no <EM>-option</EM> is specified, returns a list describing all
  287. of the available options for <EM>$tixgrid</EM> (see <STRONG>Tk_ConfigureInfo</STRONG>
  288. for information on the format of this list.) If <EM>-option</EM> is
  289. specified with no <EM>value</EM>, then the method returns a list describing
  290. the one named option (this list will be identical to the corresponding
  291. sublist of the value returned if no <EM>-option</EM> is specified).
  292. If one or more <EM>option-value</EM> pairs are specified, then the
  293. method modifies the given widget <CODE>option(s)</CODE> to have the given value(s);
  294. in this case the method returns an empty string. <EM>-option</EM> may have
  295. any of the values accepted by the <STRONG>TixGrid</STRONG> constructor method.
  296. <P></P>
  297. <DT><STRONG><A NAME="item_delete"><EM>$tixgrid</EM>-><STRONG>delete</STRONG>(<EM>dim</EM>, <EM>from</EM>?, <EM>to</EM>?)</A></STRONG><BR>
  298. <DD>
  299. <DT><STRONG><A NAME="item_deleteColumn"><EM>$tixgrid</EM>-><STRONG>deleteColumn</STRONG>(<EM>from</EM>?, <EM>to</EM>?)</A></STRONG><BR>
  300. <DD>
  301. <DT><STRONG><A NAME="item_deleteRow"><EM>$tixgrid</EM>-><STRONG>deleteRow</STRONG>(<EM>from</EM>?, <EM>to</EM>?)</A></STRONG><BR>
  302. <DD>
  303. <EM>Dim</EM> may be <STRONG>row</STRONG> or <STRONG>column</STRONG>. If <EM>to</EM> is not given,
  304. deletes a single row (or column) at the position <EM>from</EM>.
  305. If <EM>to</EM> is given, deletes the range of rows (or columns)
  306. from position <EM>from</EM> through <EM>to</EM>.
  307. <P></P>
  308. <DT><STRONG><A NAME="item_dragsite"><EM>$tixgrid</EM>-><STRONG>dragsite</STRONG>(<EM>option</EM>, <EM>x</EM>, <EM>y</EM>)</A></STRONG><BR>
  309. <DD>
  310. ?docu here? not implemented :-(
  311. <P></P>
  312. <DT><STRONG><A NAME="item_dropsite"><EM>$tixgrid</EM>-><STRONG>dropsite</STRONG>(<EM>option</EM>, <EM>x</EM>, <EM>y</EM>)</A></STRONG><BR>
  313. <DD>
  314. ?docu here? not implemented :-(
  315. <P></P>
  316. <DT><STRONG><A NAME="item_editApply"><EM>$tixgrid</EM>-><STRONG>editApply</STRONG></A></STRONG><BR>
  317. <DD>
  318. If any cell is being edited, de-highlight the cell and
  319. applies the changes.
  320. <P></P>
  321. <DT><STRONG><A NAME="item_editSet"><EM>$tixgrid</EM>-><STRONG>editSet</STRONG>(<EM>x</EM>, <EM>y</EM>)</A></STRONG><BR>
  322. <DD>
  323. Highlights the cell at (<EM>x</EM>,<EM>y</EM>) for editing,
  324. if the <STRONG>-editnotify</STRONG> callback returns true for this cell.
  325. <P></P>
  326. <DT><STRONG><A NAME="item_entrycget"><EM>$tixgrid</EM>-><STRONG>entrycget</STRONG>(<EM>x</EM>, <EM>y</EM>, '<EM>-option</EM>')</A></STRONG><BR>
  327. <DD>
  328. Returns the current value of the configuration option given by
  329. <EM>-option</EM> of the cell at (<EM>x</EM>,<EM>y</EM>).  <EM>-option</EM> may have any
  330. of the values accepted by the <STRONG>set</STRONG> method.
  331. <P></P>
  332. <DT><STRONG><A NAME="item_entryconfigure"><EM>$tixgrid</EM>-><STRONG>entryconfigure</STRONG>(<EM>x</EM>, <EM>y</EM>?, <EM>-option</EM>??=><EM>value</EM>, <EM>-option</EM>=><EM>value</EM>, <EM>...</EM>?)</A></STRONG><BR>
  333. <DD>
  334. Query or modify the configuration options of the cell at (<EM>x</EM>,<EM>y</EM>).
  335. If no <EM>-option</EM> is specified, returns a list describing all of the
  336. available options for the cell (see <STRONG>Tk_ConfigureInfo</STRONG> for information
  337. on the format of this list.)  If <EM>-option</EM> is specified with no
  338. <EM>value</EM>, then the method returns a list describing the one named
  339. option (this list will be identical to the corresponding sublist
  340. of the value returned if no <EM>-option</EM> is specified.) If one or
  341. more <EM>option-value</EM> pairs are specified, then the method modifies
  342. the given widget <CODE>option(s)</CODE> to have the given value(s); in this case
  343. the method returns an empty string.  <EM>Option</EM> may have any of the
  344. values accepted by the <STRONG>set</STRONG> method.
  345. <P></P>
  346. <DT><STRONG><A NAME="item_format"><EM>$tixgrid</EM>-><STRONG>format</STRONG>(<EM>option</EM>, ?<EM>args</EM>, ...?)</A></STRONG><BR>
  347. <DD>
  348. <DT><STRONG><A NAME="item_formatBorder"><EM>$tixgrid</EM>-><STRONG>formatBorder</STRONG>(<EM>x1,y1</EM>, <EM>x2,y2</EM>, <EM>options</EM>);</A></STRONG><BR>
  349. <DD>
  350. <DT><STRONG><A NAME="item_formatGrid"><EM>$tixgrid</EM>-><STRONG>formatGrid</STRONG>(<EM>x1,y1</EM>, <EM>x2,y2</EM>, <EM>options</EM>);</A></STRONG><BR>
  351. <DD>
  352. the <STRONG>format</STRONG> method can only be called by the <STRONG>-formatcmd</STRONG> callback
  353. of the tixGrid widget.
  354. <P>?docu complete?</P>
  355. <P></P>
  356. <DT><STRONG><A NAME="item_geometryinfo"><EM>$tixgrid</EM>-><STRONG>geometryinfo</STRONG>(?<EM>width</EM>, ?<EM>height</EM>, ...?)</A></STRONG><BR>
  357. <DD>
  358. ?docu here?  Return a list of 4 floats! Currently ``{first1 last1} {first2,last2}'' :-(
  359. <P></P>
  360. <DT><STRONG><A NAME="item_index"><EM>$tixgrid</EM>-><STRONG>index</STRONG>(<EM>$coordx</EM>, <EM>$coordy</EM>)</A></STRONG><BR>
  361. <DD>
  362. ?docu here?
  363. <P>retuns <EM>(nx, ny)</EM> of entry at position (<EM>$coordx</EM>, <EM>$coordy</EM>).
  364. (??widget or screen offset??)</P>
  365. <P></P>
  366. <DT><STRONG><A NAME="item_info"><EM>$tixgrid</EM>-><STRONG>info</STRONG>(<EM>option</EM>, ?<EM>args</EM>, ...?)</A></STRONG><BR>
  367. <DD>
  368. ?docu here?
  369. <P></P>
  370. <DT><STRONG><A NAME="item_move"><EM>$tixgrid</EM>-><STRONG>move</STRONG>(<EM>dim</EM>, <EM>from</EM>, <EM>to</EM>, <EM>offset</EM>)</A></STRONG><BR>
  371. <DD>
  372. <DT><STRONG><A NAME="item_moveColumn"><EM>$tixgrid</EM>-><STRONG>moveColumn</STRONG>(<EM>from</EM>, <EM>to</EM>, <EM>offset</EM>)</A></STRONG><BR>
  373. <DD>
  374. <DT><STRONG><A NAME="item_moveRow"><EM>$tixgrid</EM>-><STRONG>moveRow</STRONG>(<EM>from</EM>, <EM>to</EM>, <EM>offset</EM>)</A></STRONG><BR>
  375. <DD>
  376. <EM>Dim</EM> may be <STRONG>row</STRONG> or <STRONG>column</STRONG>. Moves the range of rows
  377. (or columns) from position <EM>from</EM> through <EM>to</EM> by the distance
  378. indicated by <EM>offset</EM>. For example,
  379. <EM>$tixgrid</EM>-><STRONG>moveRow</STRONG>(<STRONG>2</STRONG>, <STRONG>4</STRONG>, <STRONG>1</STRONG>) moves the rows 2,3,4
  380. to rows 3,4,5.
  381. <P></P>
  382. <DT><STRONG><A NAME="item_nearest"><EM>$tixgrid</EM>-><STRONG>nearest</STRONG>(<EM>x</EM>, <EM>y</EM>)</A></STRONG><BR>
  383. <DD>
  384. ?docu here?  screen pos (pixels) to entry (nx,ny) translation.
  385. <P></P>
  386. <DT><STRONG><A NAME="item_selection"><EM>$tixgrid</EM>-><STRONG>selection</STRONG>(<EM>option</EM>, <EM>x1</EM>, <EM>y1</EM> ?,<EM>x2</EM>, <EM>y2</EM>?)</A></STRONG><BR>
  387. <DD>
  388. <DT><STRONG><A NAME="item_selectionOption"><EM>$tixgrid</EM>-><STRONG>selection</STRONG><EM>Option</EM>(<EM>x1</EM>, <EM>y1</EM> ?,<EM>x2</EM>, <EM>y2</EM>?)</A></STRONG><BR>
  389. <DD>
  390. Option one of: <STRONG>adjust</STRONG>, <STRONG>clear</STRONG>, <STRONG>includes</STRONG>, <STRONG>set</STRONG>, and <STRONG>toggle</STRONG>.
  391. <P>x1 (y1) has not to be greater than x2 (y2), but only x2 and y2 can be 'max'.</P>
  392. <P>BUG: <EM>selection includes</EM>: has no visible effect (as in Tix). Eh???</P>
  393. <P>BUG: <EM>selection clear</EM>: only works for 0, 0, max, max (as in Tix). Eh???</P>
  394. <P>When <EM>x2, y2</EM> are not given they default to <EM>x1, y1</EM>, respectively.</P>
  395. <DL>
  396. <DT><STRONG><A NAME="item_selectionAdjust"><EM>$tixgrid</EM>-><STRONG>selectionAdjust</STRONG>(<EM>x1</EM>, <EM>y1</EM> ?,<EM>x2</EM>, <EM>y2</EM>?)</A></STRONG><BR>
  397. <DD>
  398. ?docu here?
  399. <P></P>
  400. <DT><STRONG><A NAME="item_selectionClear"><EM>$tixgrid</EM>-><STRONG>selectionClear</STRONG>(<EM>x1</EM>, <EM>y1</EM> ?,<EM>x2</EM>, <EM>y2</EM>?)</A></STRONG><BR>
  401. <DD>
  402. ?docu here?
  403. <P></P>
  404. <DT><STRONG><A NAME="item_selectionIncludes"><EM>$tixgrid</EM>-><STRONG>selectionIncludes</STRONG>(<EM>x1</EM>, <EM>y1</EM> ?,<EM>x2</EM>, <EM>y2</EM>?)</A></STRONG><BR>
  405. <DD>
  406. ?docu here?
  407. <P></P>
  408. <DT><STRONG><A NAME="item_selectionSet"><EM>$tixgrid</EM>-><STRONG>selectionSet</STRONG>(<EM>x1</EM>, <EM>y1</EM> ?,<EM>x2</EM>, <EM>y2</EM>?)</A></STRONG><BR>
  409. <DD>
  410. ?docu here?
  411. <P></P>
  412. <DT><STRONG><A NAME="item_selectionToggle"><EM>$tixgrid</EM>-><STRONG>selectionToggle</STRONG>(<EM>x1</EM>, <EM>y1</EM> ?,<EM>x2</EM>, <EM>y2</EM>?)</A></STRONG><BR>
  413. <DD>
  414. ?docu here?
  415. <P></P></DL>
  416. <DT><STRONG><A NAME="item_set"><EM>$tixgrid</EM>-><STRONG>set</STRONG>(<EM>x</EM>, <EM>y</EM>?, <STRONG>-itemtype</STRONG>=><EM>type</EM>??, <EM>-option</EM>=><EM>value</EM>, <EM>...</EM>?)</A></STRONG><BR>
  417. <DD>
  418. Creates a new display item at the cell at (<EM>x</EM>,<EM>y</EM>). The optional
  419. <STRONG>-itemtype</STRONG> parameter gives the type of the display item.
  420. An additional list of <EM>option-value</EM> pairs specify options
  421. of the display item. If a display item already exists at this cell,
  422. the old item will be deleted automatically.
  423. <P></P>
  424. <DT><STRONG><A NAME="item_size"><EM>$tixgrid</EM>-><STRONG>size</STRONG>(<EM>dim</EM>, <EM>index</EM>?, <EM>-option</EM>??=><EM>value</EM>, <EM>...</EM>?)</A></STRONG><BR>
  425. <DD>
  426. <DT><STRONG><A NAME="item_sizeColumn"><EM>$tixgrid</EM>-><STRONG>sizeColumn</STRONG>(<EM>index</EM>?, <EM>-option</EM>??=><EM>value</EM>, <EM>...</EM>?)</A></STRONG><BR>
  427. <DD>
  428. <DT><STRONG><A NAME="item_sizeRow"><EM>$tixgrid</EM>-><STRONG>sizeRow</STRONG>(<EM>index</EM>?, <EM>-option</EM>??=><EM>value</EM>, <EM>...</EM>?)</A></STRONG><BR>
  429. <DD>
  430. Queries or sets the size of the row or column given by <EM>dim</EM> and
  431. <EM>index</EM>. <EM>Dim</EM> may be <STRONG>row</STRONG> or <STRONG>column</STRONG>.  <EM>Index</EM> may be any
  432. non-negative integer that gives the position of a given row (or column).
  433. <EM>Index</EM> can also be the string <STRONG>default</STRONG>; in this case, this method
  434. queries or sets the default size of all rows (or columns).
  435. When no <EM>option-value</EM> pair is given, this method returns
  436. a list containing the current size setting of the given row (or column).
  437. When <EM>option-value</EM> pairs are given, the corresponding options
  438. of the size setting of the given row are changed. <EM>-option</EM> may be
  439. one of the following:
  440. <DL>
  441. <DT><STRONG><A NAME="item_%2Dpad0_%3D%3E_pixels"><STRONG>-pad0</STRONG> => <EM>pixels</EM></A></STRONG><BR>
  442. <DD>
  443. Specifies the paddings to the left of a column or the top of a row.
  444. <P></P>
  445. <DT><STRONG><A NAME="item_%2Dpad1_%3D%3E_pixels"><STRONG>-pad1</STRONG> => <EM>pixels</EM></A></STRONG><BR>
  446. <DD>
  447. Specifies the paddings to the right of a column or the bottom of a row.
  448. <P></P>
  449. <DT><STRONG><A NAME="item_%2Dsize_%3D%3E_val"><STRONG>-size</STRONG> => <EM>val</EM></A></STRONG><BR>
  450. <DD>
  451. Specifies the width of a column or the height of a row.
  452. <EM>Val</EM> may be: <STRONG>auto</STRONG> -- the width of the column is set
  453. the widest cell in the column; a valid Tk screen distance
  454. unit (see <STRONG>Tk_GetPixels</STRONG>); or a real number following by the
  455. word <STRONG>chars</STRONG> (e.g. <STRONG>3.4chars</STRONG>) that sets the width of the
  456. column to the given number of characters.
  457. <P></P></DL>
  458. <DT><STRONG><A NAME="item_sort"><EM>$tixgrid</EM>-><STRONG>sort</STRONG>(<EM>dimension</EM>, <EM>start</EM>, <EM>end</EM>, ?<EM>args ...</EM>?)</A></STRONG><BR>
  459. <DD>
  460. ?docu here? (not supported on Win* OSs up to now)
  461. <P></P>
  462. <DT><STRONG><A NAME="item_unset"><EM>$tixgrid</EM>-><STRONG>unset</STRONG>(<EM>x</EM>, <EM>y</EM>)</A></STRONG><BR>
  463. <DD>
  464. Clears the cell at (<EM>x</EM>,<EM>y</EM>) by removing its display item.
  465. <P></P>
  466. <DT><STRONG><A NAME="item_xview"><EM>$tixgrid</EM>-><STRONG>xview</STRONG></A></STRONG><BR>
  467. <DD>
  468. ?docu here?
  469. <P></P>
  470. <DT><STRONG><A NAME="item_yview"><EM>$tixgrid</EM>-><STRONG>yview</STRONG></A></STRONG><BR>
  471. <DD>
  472. ?docu here?
  473. <P></P></DL>
  474. <P>
  475. <HR>
  476. <H1><A NAME="bindings">BINDINGS</A></H1>
  477. <P>to be done.</P>
  478. <P>
  479. <HR>
  480. <H1><A NAME="see also">SEE ALSO</A></H1>
  481. <P><A HREF="../../../site/lib/Tk/DItem.html">Tk::DItem</A>
  482. <A HREF="../../../site/lib/Tk/callbacks.html">Tk::callbacks</A>
  483. <A HREF="../../../site/lib/Tk/FloatEntry.html">Tk::FloatEntry</A></P>
  484. <P>
  485. <HR>
  486. <H1><A NAME="bugs">BUGS</A></H1>
  487. <P>C code and bindings of TixGrid have some bugs.</P>
  488. <P>
  489. <HR>
  490. <H1><A NAME="keywords">KEYWORDS</A></H1>
  491. <P>tix, tixgrid, table, display item, spreadsheet</P>
  492. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  493. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  494. <STRONG><P CLASS=block> Tk::TixGrid - Create and manipulate Tix Grid widgets</P></STRONG>
  495. </TD></TR>
  496. </TABLE>
  497.  
  498. </BODY>
  499.  
  500. </HTML>
  501.