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
|
<!DOCTYPE html>
<html>
<head>
<title>Interactive Tablelist Cell Editing Using the combobox Package</title>
<meta name="Author" content="Csaba Nemethi">
<meta name="Keywords" content="tablelist, editing, combobox">
<link rel="stylesheet" type="text/css" href="stylesheet.css">
</head>
<body>
<div align="center">
<h1>Interactive Tablelist Cell Editing Using the combobox Package</h1>
<h2>For Tablelist Version 6.11</h2>
<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 id="contents">Contents</h2>
<ul>
<li><a href="#overview">Overview</a></li>
<li><a href="#combobox">The
<code><b>tablelist::addOakleyCombobox</b></code> Command</a></li>
</ul>
<div align="center">
<p><a href="index.html">Start page</a></p>
</div>
<hr>
<h2 id="overview">Overview</h2>
<p>Bryan Oakley's combobox package is a library extension for Tcl/Tk versions
8.0 or higher, written in pure Tcl/Tk code. Its download location
is</p>
<blockquote>
<address>
<a href=
"http://www1.clearlight.com/~oakley/tcl/combobox">http://www1.clearlight.com/~oakley/tcl/combobox</a>
</address>
</blockquote>
<p>Tablelist supports interactive cell editing with the aid of the combobox
widget implemented in the package mentioned above. The steps needed for
using this widget for editing the cells of a given column are as follows:</p>
<ol>
<li>Register the combobox widget for interactive cell editing by invoking
the <code><b><a href=
"#combobox">tablelist::addOakleyCombobox</a></b></code> command described
below.</li>
<li class="tm">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
the value returned by the command mentioned above. (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.)</li>
</ol>
<p><b>REMARK:</b> The arrow and scrollbar components of the temporary
embedded combobox widget used for interactive cell editing will appear
properly scaled, according to the display's DPI scaling level, given by the
variable <code><b>tablelist::scalingpct</b></code>.</p>
<div align="center">
<p><a href="#contents">Contents</a> <a href=
"index.html">Start page</a></p>
</div>
<hr>
<h2 id="combobox">The <code><b>tablelist::addOakleyCombobox</b></code>
Command</h2>
<dl>
<dt><b>NAME</b></dt>
<dd><code>tablelist::addOakleyCombobox</code> – Register Bryan
Oakley's combobox widget for interactive cell editing</dd>
<dt class="tm"><b>SYNOPSIS</b></dt>
<dd>
<pre>
<b>tablelist::addOakleyCombobox</b> ?<i>name</i>?
</pre>
</dd>
<dt><b>DESCRIPTION</b></dt>
<dd>This command registers Bryan Oakley's combobox widget for interactive
cell editing in tablelist widgets. The optional argument specifies
the name to be used for the combobox widget as the value of the
<code><b><a href=
"tablelistWidget.html#col_editwindow">-editwindow</a></b></code> column or
cell configuration option. It may be any string that is different
from the <a href="tablelistTkCore.html">Tk core</a> and <a href=
"tablelistTile.html">tile</a> edit window names. The default is
<code><b>combobox</b></code>. The command returns its
<code><i>name</i></code> argument.</dd>
<dd class="tm">The temporary embedded combobox widget associated with the
above <code><i>name</i></code> will be created with its
<code><b>-editable</b></code> option set to <code>1</code>. You can
use the script corresponding to the <code><b><a href=
"tablelistWidget.html#editstartcommand">-editstartcommand</a></b></code>
tablelist configuration option to make the combobox non-editable or define
validations for its entry child (whose path name can be obtained by
invoking the tablelist widget's <code><b><a href=
"tablelistWidget.html#entrypath">entrypath</a></b></code> subcommand, or by
appending <code><b>.entry</b></code> to the path name of the combobox
widget, or, if using combobox version 2.3 or later, with the aid of the
combobox widget's <code><b>subwidget entry</b></code>
subcommand), as well as for populating its listbox component (by using the
combobox widget's <code><b>list insert</b></code>
subcommand).</dd>
<dt class="tm"><b>KEYWORDS</b></dt>
<dd>tablelist, editing, combobox</dd>
</dl>
<div align="center">
<p><a href="index.html">Start page</a></p>
</div>
</body>
</html>
|