1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
|
<html>
<head>
<title>Interactive Tablelist Cell Editing Using Tk Core Widgets</title>
<meta name="Author" content="Csaba Nemethi">
<meta name="Keywords" content="tablelist, editing, Tk core">
</head>
<body bgcolor="#FFFFFF">
<div align="center">
<h1>Interactive Tablelist Cell Editing Using Tk Core Widgets</h1>
<h3>by</h3>
<h2>Csaba Nemethi</h2>
<address>
<a href="mailto:csaba.nemethi@t-online.de">csaba.nemethi@t-online.de</a>
</address>
</div>
<hr>
<h2><a name="contents"></a>Contents</h2>
<ul>
<li><a href="#overview">Overview</a></li>
<li><a href="#entry">Interactive Cell Editing Using the entry
Widget</a></li>
<li><a href="#text">Interactive Cell Editing Using the text Widget</a></li>
<li><a href="#spinbox">Interactive Cell Editing Using the spinbox
Widget</a></li>
<li><a href="#checkbutton">Interactive Cell Editing Using the checkbutton
Widget</a></li>
</ul>
<div align="center">
<p><a href="index.html">Start page</a></p>
</div>
<hr>
<h2><a name="overview"></a>Overview</h2>
<p>Tablelist supports interactive cell editing with the aid of the Tk core
entry, text, spinbox, and checkbutton widgets. These widgets are
automatically registered for cell editing, hence the only action needed for
using one of them for editing the cells of a given column is as follows:</p>
<p>Use the tablelist widget's <code><b><a href=
"tablelistWidget.html#columnconfigure">columnconfigure</a></b></code>
subcommand to set the given column's <code><b><a href=
"tablelistWidget.html#col_editable">-editable</a></b></code> option to true
and its <code><b><a href=
"tablelistWidget.html#col_editwindow">-editwindow</a></b></code> option to
<code><b>entry</b></code>, <code><b>text</b></code>,
<code><b>spinbox</b></code>, or <code><b>checkbutton</b></code>,
respectively. (These options are supported at cell level, too, with the
aid of the <code><b><a href=
"tablelistWidget.html#cellconfigure">cellconfigure</a></b></code>
subcommand.) Since the default value of the
<code><b>-editwindow</b></code> column configuration option is
<code><b>entry</b></code>, it is not necessary to set it explicitly if the
editing should take place with the aid of an embedded entry widget.</p>
<div align="center">
<p><a href="#contents">Contents</a> <a href=
"index.html">Start page</a></p>
</div>
<hr>
<h2><a name="entry"></a>Interactive Cell Editing Using the entry Widget</h2>
<dl>
<dt><b>DESCRIPTION</b></dt>
<dd>As mentioned above, the interactive cell editing in a tablelist widget
takes place per default with the aid of an embedded entry widget.
Refer to the <a href="tablelistWidget.html#cell_editing">INTERACTIVE CELL
EDITING</a> section of the reference page describing the
<code><b>tablelist::tablelist</b></code> command for details on the editing
process.</dd>
<dt><br>
<b>KEYWORDS</b></dt>
<dd>tablelist, editing, entry</dd>
</dl>
<div align="center">
<p><a href="#contents">Contents</a> <a href=
"index.html">Start page</a></p>
</div>
<hr>
<h2><a name="text"></a>Interactive Cell Editing Using the text Widget</h2>
<dl>
<dt><b>DESCRIPTION</b></dt>
<dd>The temporary embedded text widget used for interactive cell editing
will be created with its <code><b>-padx</b></code> and
<code><b>-pady</b></code> options set to <code>2</code>, its
<code><b>-wrap</b></code> option set to <code><b>none</b></code>, and its
initial height set to the number of lines contained in it. There is,
however, an exception from this rule: If the <code><b><a href=
"tablelistWidget.html#col_wrap">-wrap</a></b></code> option of the cell's
column was set to true and Tk version 8.5 or higher is being used, then the
text widget's <code><b>-wrap</b></code> option will be set to
<code><b>word</b></code> and its initial height will equal the number of
<i>display</i> lines (taking into account the line wraps) contained in
it. You can use the script corresponding to the <code><b><a href=
"tablelistWidget.html#editstartcommand">-editstartcommand</a></b></code>
tablelist configuration option to override the initial settings according
to your needs.</d>
<dd><br>
If the text widget's <code><b>-wrap</b></code> option was set to
<code><b>word</b></code> or <code><b>char</b></code> (either by Tablelist
or from within the above-mentioned script) and Tk version 8.5 or higher is
being used, then, whenever its width changes (e.g., due to interactive
column resizing), its height will be set automatically to the number of
display lines contained in it. (The number of display lines is
retrieved with the aid of the
<code><b>count -displaylines</b></code> text widget subcommand,
introduced in Tk 8.5.)</dd>
<dd><br>
If the widget callback package Wcb was loaded into the interpreter
(via <code><b>package require Wcb</b></code> or
<code><b>package require wcb</b></code>) then the text widget's
height will be updated automatically whenever text is inserted into or
deleted from it, which makes the editing much more user-friendly.
This is achieved by using an appropriately defined
after-<code><b>insert</b></code> and after-<code><b>delete</b></code>
callback for the edit window. You can use the script corresponding to
the <code><b><a href=
"tablelistWidget.html#editstartcommand">-editstartcommand</a></b></code>
tablelist configuration option to define further callbacks for the text
widget.  (The above-mentioned callback is created via
<code><b>wcb::cbappend</b></code>, <i>after</i> returning from that
script.)</dd>
<dd><br>
The <code>Tab</code> key is reserved for navigation between the editable
cells, but the user can insert a tabulator character into the text widget
by pressing <code>Control-i</code>.</dd>
<dd><br>
Unlike in the case of the other widgets used for interactive cell editing,
the <code>Return</code> and <code>KP_Enter</code> keys insert a newline
character into the text widget. <code>Control-j</code> can also be
used for inserting a newline. <code>Control-Return</code> and
<code>Control-KP_Enter</code> terminate the editing and destroy the edit
window.</dd>
<dd><br>
<code>Control-Home</code> and <code>Control-End</code> have their
well-known text widget-specific bindings, just like <code>Meta-<</code>
and <code>Meta-></code> if <code><b>tk_strictMotif</b></code> is
false. Again, this is different from the behavior of the other
widgets used for interactive cell editing. For jumping into the
first/last editable cell, the user can press
<code>Alt-Home</code>/<code>Alt-End</code> or
<code>Meta-Home</code>/<code>Meta-End</code>
(<code>Command-Home</code>/<code>Command-End</code> on Mac OS Classic and
Mac OS X Aqua).</dd>
<dt><br>
<b>KEYWORDS</b></dt>
<dd>tablelist, editing, text</dd>
</dl>
<div align="center">
<p><a href="#contents">Contents</a> <a href=
"index.html">Start page</a></p>
</div>
<hr>
<h2><a name="spinbox"></a>Interactive Cell Editing Using the spinbox
Widget</h2>
<dl>
<dt><b>DESCRIPTION</b></dt>
<dd>The temporary embedded spinbox widget used for interactive cell editing
will be created with its <code><b>-state</b></code> option set to
<code><b>normal</b></code>, which makes the widget editable. You can
use the script corresponding to the <code><b><a href=
"tablelistWidget.html#editstartcommand">-editstartcommand</a></b></code>
tablelist configuration option to set the state of the spinbox to
<code><b>readonly</b></code> or define validations for it, as well as for
setting its (range of) values and its <code><b>-wrap</b></code>
option.</dd>
<dt><br>
<b>KEYWORDS</b></dt>
<dd>tablelist, editing, spinbox</dd>
</dl>
<div align="center">
<p><a href="#contents">Contents</a> <a href=
"index.html">Start page</a></p>
</div>
<hr>
<h2><a name="checkbutton"></a>Interactive Cell Editing Using the checkbutton
Widget</h2>
<dl>
<dt><b>DESCRIPTION</b></dt>
<dd>On Windows, Mac OS Classic, and Mac OS X Aqua the temporary embedded
checkbutton widget used for interactive cell editing will be created with
explicitly set values for its <code><b>-borderwidth</b></code>,
<code><b>-font</b></code>, <code><b>-padx</b></code>,
<code><b>-pady</b></code>, and <code><b>-variable</b></code> options.
In an X11 environment it will be created with explicitly set values for its
<code><b>-borderwidth</b></code>, <code><b>-indicatoron</b></code>,
<code><b>-image</b></code>, <code><b>-selectimage</b></code>,
<code><b>-selectcolor</b></code>, and <code><b>-variable</b></code>
options. You can use the script corresponding to the
<code><b><a href="tablelistWidget.html#editstartcommand">-editstartcommand</a></b></code>
tablelist configuration option to set any other configuration options, like
<code><b>-offvalue</b></code> and <code><b>-onvalue</b></code>, according
to the <i>internal</i> values of the cells. Since the default values
of the <code><b>-offvalue</b></code> and <code><b>-onvalue</b></code>
checkbutton options are <code>0</code> and <code>1</code>, you don't need
to change these options if the cells have the same internal values
<code>0</code> and <code>1</code>.</dd>
<dt><br>
<b>KEYWORDS</b></dt>
<dd>tablelist, editing, checkbutton</dd>
</dl>
<div align="center">
<p><a href="#contents">Contents</a> <a href=
"index.html">Start page</a></p>
</div>
</body>
</html>
|
