Pratt 1.5.6
Sign up to get free protection for your applications and to get access to all the features.
- data/.exrc +61 -0
- data/.gitignore +4 -0
- data/History.txt +6 -0
- data/Manifest.txt +46 -0
- data/Pratt.gemspec +351 -0
- data/README.txt +66 -0
- data/Rakefile +85 -0
- data/TODO +54 -0
- data/VERSION +1 -0
- data/bin/pratt.rb +13 -0
- data/config.rb +34 -0
- data/lib/pratt.rb +527 -0
- data/lib/pratt/array.rb +11 -0
- data/lib/pratt/string.rb +18 -0
- data/models/app.rb +40 -0
- data/models/customer.rb +24 -0
- data/models/payment.rb +22 -0
- data/models/pratt.rb +19 -0
- data/models/project.rb +82 -0
- data/models/whence.rb +70 -0
- data/pkgs/tile-0.8.2.tar.gz +0 -0
- data/pkgs/tile-0.8.2/ANNOUNCE.txt +95 -0
- data/pkgs/tile-0.8.2/ChangeLog +4651 -0
- data/pkgs/tile-0.8.2/Makefile +250 -0
- data/pkgs/tile-0.8.2/Makefile.in +250 -0
- data/pkgs/tile-0.8.2/README.txt +86 -0
- data/pkgs/tile-0.8.2/aclocal.m4 +2 -0
- data/pkgs/tile-0.8.2/altTheme.o +0 -0
- data/pkgs/tile-0.8.2/blink.o +0 -0
- data/pkgs/tile-0.8.2/button.o +0 -0
- data/pkgs/tile-0.8.2/cache.o +0 -0
- data/pkgs/tile-0.8.2/clamTheme.o +0 -0
- data/pkgs/tile-0.8.2/classicTheme.o +0 -0
- data/pkgs/tile-0.8.2/config.log +1330 -0
- data/pkgs/tile-0.8.2/config.status +795 -0
- data/pkgs/tile-0.8.2/configure +15248 -0
- data/pkgs/tile-0.8.2/configure.in +89 -0
- data/pkgs/tile-0.8.2/demos/autocomplete.tcl +59 -0
- data/pkgs/tile-0.8.2/demos/demo.tcl +870 -0
- data/pkgs/tile-0.8.2/demos/dirbrowser.tcl +167 -0
- data/pkgs/tile-0.8.2/demos/dlgtest.tcl +97 -0
- data/pkgs/tile-0.8.2/demos/iconlib.tcl +110 -0
- data/pkgs/tile-0.8.2/demos/repeater.tcl +117 -0
- data/pkgs/tile-0.8.2/demos/toolbutton.tcl +101 -0
- data/pkgs/tile-0.8.2/doc/Geometry.3 +230 -0
- data/pkgs/tile-0.8.2/doc/INDEX.MAP +153 -0
- data/pkgs/tile-0.8.2/doc/Makefile +36 -0
- data/pkgs/tile-0.8.2/doc/TILE.XML +45 -0
- data/pkgs/tile-0.8.2/doc/Theme.3 +34 -0
- data/pkgs/tile-0.8.2/doc/button.n +75 -0
- data/pkgs/tile-0.8.2/doc/checkbutton.n +61 -0
- data/pkgs/tile-0.8.2/doc/combobox.n +98 -0
- data/pkgs/tile-0.8.2/doc/converting.txt +97 -0
- data/pkgs/tile-0.8.2/doc/dialog.n +122 -0
- data/pkgs/tile-0.8.2/doc/entry.n +438 -0
- data/pkgs/tile-0.8.2/doc/frame.n +43 -0
- data/pkgs/tile-0.8.2/doc/html/Geometry.html +304 -0
- data/pkgs/tile-0.8.2/doc/html/Theme.html +48 -0
- data/pkgs/tile-0.8.2/doc/html/button.html +120 -0
- data/pkgs/tile-0.8.2/doc/html/category-index.html +18 -0
- data/pkgs/tile-0.8.2/doc/html/checkbutton.html +94 -0
- data/pkgs/tile-0.8.2/doc/html/combobox.html +164 -0
- data/pkgs/tile-0.8.2/doc/html/converting.txt +97 -0
- data/pkgs/tile-0.8.2/doc/html/dialog.html +159 -0
- data/pkgs/tile-0.8.2/doc/html/entry.html +613 -0
- data/pkgs/tile-0.8.2/doc/html/frame.html +76 -0
- data/pkgs/tile-0.8.2/doc/html/image.html +100 -0
- data/pkgs/tile-0.8.2/doc/html/index.html +25 -0
- data/pkgs/tile-0.8.2/doc/html/keyword-index.html +228 -0
- data/pkgs/tile-0.8.2/doc/html/label.html +133 -0
- data/pkgs/tile-0.8.2/doc/html/labelframe.html +91 -0
- data/pkgs/tile-0.8.2/doc/html/manpage.css +212 -0
- data/pkgs/tile-0.8.2/doc/html/menubutton.html +63 -0
- data/pkgs/tile-0.8.2/doc/html/notebook.html +280 -0
- data/pkgs/tile-0.8.2/doc/html/paned.html +149 -0
- data/pkgs/tile-0.8.2/doc/html/progressbar.html +138 -0
- data/pkgs/tile-0.8.2/doc/html/radiobutton.html +89 -0
- data/pkgs/tile-0.8.2/doc/html/scrollbar.html +221 -0
- data/pkgs/tile-0.8.2/doc/html/separator.html +48 -0
- data/pkgs/tile-0.8.2/doc/html/sizegrip.html +62 -0
- data/pkgs/tile-0.8.2/doc/html/style.html +172 -0
- data/pkgs/tile-0.8.2/doc/html/tile-intro.html +164 -0
- data/pkgs/tile-0.8.2/doc/html/treeview.html +634 -0
- data/pkgs/tile-0.8.2/doc/html/widget.html +342 -0
- data/pkgs/tile-0.8.2/doc/image.n +81 -0
- data/pkgs/tile-0.8.2/doc/internals.txt +409 -0
- data/pkgs/tile-0.8.2/doc/label.n +75 -0
- data/pkgs/tile-0.8.2/doc/labelframe.n +64 -0
- data/pkgs/tile-0.8.2/doc/man.macros +239 -0
- data/pkgs/tile-0.8.2/doc/menubutton.n +41 -0
- data/pkgs/tile-0.8.2/doc/notebook.n +188 -0
- data/pkgs/tile-0.8.2/doc/paned.n +95 -0
- data/pkgs/tile-0.8.2/doc/progressbar.n +79 -0
- data/pkgs/tile-0.8.2/doc/radiobutton.n +57 -0
- data/pkgs/tile-0.8.2/doc/scrollbar.n +160 -0
- data/pkgs/tile-0.8.2/doc/separator.n +30 -0
- data/pkgs/tile-0.8.2/doc/sizegrip.n +53 -0
- data/pkgs/tile-0.8.2/doc/style.n +119 -0
- data/pkgs/tile-0.8.2/doc/tile-intro.n +165 -0
- data/pkgs/tile-0.8.2/doc/tmml.options +4 -0
- data/pkgs/tile-0.8.2/doc/treeview.n +415 -0
- data/pkgs/tile-0.8.2/doc/widget.n +227 -0
- data/pkgs/tile-0.8.2/doc/xml/Geometry.tmml +379 -0
- data/pkgs/tile-0.8.2/doc/xml/INDEX.MAP +153 -0
- data/pkgs/tile-0.8.2/doc/xml/Theme.tmml +63 -0
- data/pkgs/tile-0.8.2/doc/xml/button.tmml +134 -0
- data/pkgs/tile-0.8.2/doc/xml/checkbutton.tmml +119 -0
- data/pkgs/tile-0.8.2/doc/xml/combobox.tmml +184 -0
- data/pkgs/tile-0.8.2/doc/xml/dialog.tmml +195 -0
- data/pkgs/tile-0.8.2/doc/xml/entry.tmml +630 -0
- data/pkgs/tile-0.8.2/doc/xml/frame.tmml +98 -0
- data/pkgs/tile-0.8.2/doc/xml/image.tmml +101 -0
- data/pkgs/tile-0.8.2/doc/xml/label.tmml +154 -0
- data/pkgs/tile-0.8.2/doc/xml/labelframe.tmml +116 -0
- data/pkgs/tile-0.8.2/doc/xml/menubutton.tmml +80 -0
- data/pkgs/tile-0.8.2/doc/xml/notebook.tmml +306 -0
- data/pkgs/tile-0.8.2/doc/xml/paned.tmml +154 -0
- data/pkgs/tile-0.8.2/doc/xml/progressbar.tmml +151 -0
- data/pkgs/tile-0.8.2/doc/xml/radiobutton.tmml +109 -0
- data/pkgs/tile-0.8.2/doc/xml/scrollbar.tmml +233 -0
- data/pkgs/tile-0.8.2/doc/xml/separator.tmml +59 -0
- data/pkgs/tile-0.8.2/doc/xml/sizegrip.tmml +82 -0
- data/pkgs/tile-0.8.2/doc/xml/style.tmml +171 -0
- data/pkgs/tile-0.8.2/doc/xml/tile-intro.tmml +192 -0
- data/pkgs/tile-0.8.2/doc/xml/treeview.tmml +604 -0
- data/pkgs/tile-0.8.2/doc/xml/widget.tmml +372 -0
- data/pkgs/tile-0.8.2/entry.o +0 -0
- data/pkgs/tile-0.8.2/frame.o +0 -0
- data/pkgs/tile-0.8.2/generic/Makefile.in +221 -0
- data/pkgs/tile-0.8.2/generic/TODO +493 -0
- data/pkgs/tile-0.8.2/generic/altTheme.c +1172 -0
- data/pkgs/tile-0.8.2/generic/blink.c +168 -0
- data/pkgs/tile-0.8.2/generic/button.c +858 -0
- data/pkgs/tile-0.8.2/generic/cache.c +354 -0
- data/pkgs/tile-0.8.2/generic/clamTheme.c +974 -0
- data/pkgs/tile-0.8.2/generic/classicTheme.c +518 -0
- data/pkgs/tile-0.8.2/generic/configure +10334 -0
- data/pkgs/tile-0.8.2/generic/configure.in +100 -0
- data/pkgs/tile-0.8.2/generic/entry.c +1922 -0
- data/pkgs/tile-0.8.2/generic/frame.c +648 -0
- data/pkgs/tile-0.8.2/generic/gunk.h +44 -0
- data/pkgs/tile-0.8.2/generic/image.c +416 -0
- data/pkgs/tile-0.8.2/generic/label.c +663 -0
- data/pkgs/tile-0.8.2/generic/layout.c +1215 -0
- data/pkgs/tile-0.8.2/generic/manager.c +554 -0
- data/pkgs/tile-0.8.2/generic/manager.h +91 -0
- data/pkgs/tile-0.8.2/generic/notebook.c +1380 -0
- data/pkgs/tile-0.8.2/generic/paned.c +958 -0
- data/pkgs/tile-0.8.2/generic/pkgIndex.tcl.in +7 -0
- data/pkgs/tile-0.8.2/generic/progress.c +549 -0
- data/pkgs/tile-0.8.2/generic/scale.c +526 -0
- data/pkgs/tile-0.8.2/generic/scroll.c +253 -0
- data/pkgs/tile-0.8.2/generic/scrollbar.c +346 -0
- data/pkgs/tile-0.8.2/generic/separator.c +132 -0
- data/pkgs/tile-0.8.2/generic/square.c +306 -0
- data/pkgs/tile-0.8.2/generic/tagset.c +147 -0
- data/pkgs/tile-0.8.2/generic/tile.c +296 -0
- data/pkgs/tile-0.8.2/generic/tkElements.c +1280 -0
- data/pkgs/tile-0.8.2/generic/tkTheme.c +1708 -0
- data/pkgs/tile-0.8.2/generic/tkTheme.h +419 -0
- data/pkgs/tile-0.8.2/generic/tkThemeInt.h +45 -0
- data/pkgs/tile-0.8.2/generic/tkstate.c +268 -0
- data/pkgs/tile-0.8.2/generic/trace.c +145 -0
- data/pkgs/tile-0.8.2/generic/track.c +174 -0
- data/pkgs/tile-0.8.2/generic/treeview.c +3211 -0
- data/pkgs/tile-0.8.2/generic/ttk.decls +154 -0
- data/pkgs/tile-0.8.2/generic/ttkDecls.h +340 -0
- data/pkgs/tile-0.8.2/generic/ttkStubInit.c +61 -0
- data/pkgs/tile-0.8.2/generic/ttkStubLib.c +70 -0
- data/pkgs/tile-0.8.2/generic/widget.c +785 -0
- data/pkgs/tile-0.8.2/generic/widget.h +263 -0
- data/pkgs/tile-0.8.2/image.o +0 -0
- data/pkgs/tile-0.8.2/label.o +0 -0
- data/pkgs/tile-0.8.2/layout.o +0 -0
- data/pkgs/tile-0.8.2/library/altTheme.tcl +101 -0
- data/pkgs/tile-0.8.2/library/aquaTheme.tcl +62 -0
- data/pkgs/tile-0.8.2/library/button.tcl +85 -0
- data/pkgs/tile-0.8.2/library/clamTheme.tcl +139 -0
- data/pkgs/tile-0.8.2/library/classicTheme.tcl +108 -0
- data/pkgs/tile-0.8.2/library/combobox.tcl +439 -0
- data/pkgs/tile-0.8.2/library/cursors.tcl +36 -0
- data/pkgs/tile-0.8.2/library/defaults.tcl +118 -0
- data/pkgs/tile-0.8.2/library/dialog.tcl +274 -0
- data/pkgs/tile-0.8.2/library/entry.tcl +580 -0
- data/pkgs/tile-0.8.2/library/fonts.tcl +153 -0
- data/pkgs/tile-0.8.2/library/icons.tcl +105 -0
- data/pkgs/tile-0.8.2/library/keynav.tcl +192 -0
- data/pkgs/tile-0.8.2/library/menubutton.tcl +171 -0
- data/pkgs/tile-0.8.2/library/notebook.tcl +193 -0
- data/pkgs/tile-0.8.2/library/paned.tcl +87 -0
- data/pkgs/tile-0.8.2/library/progress.tcl +51 -0
- data/pkgs/tile-0.8.2/library/scale.tcl +54 -0
- data/pkgs/tile-0.8.2/library/scrollbar.tcl +125 -0
- data/pkgs/tile-0.8.2/library/sizegrip.tcl +77 -0
- data/pkgs/tile-0.8.2/library/tile.tcl +211 -0
- data/pkgs/tile-0.8.2/library/treeview.tcl +382 -0
- data/pkgs/tile-0.8.2/library/utils.tcl +254 -0
- data/pkgs/tile-0.8.2/library/winTheme.tcl +77 -0
- data/pkgs/tile-0.8.2/library/xpTheme.tcl +63 -0
- data/pkgs/tile-0.8.2/libtile0.8.2.so +0 -0
- data/pkgs/tile-0.8.2/libttkstub.a +0 -0
- data/pkgs/tile-0.8.2/license.terms +24 -0
- data/pkgs/tile-0.8.2/macosx/aquaTheme.c +1076 -0
- data/pkgs/tile-0.8.2/manager.o +0 -0
- data/pkgs/tile-0.8.2/notebook.o +0 -0
- data/pkgs/tile-0.8.2/paned.o +0 -0
- data/pkgs/tile-0.8.2/pkgIndex.tcl +3 -0
- data/pkgs/tile-0.8.2/progress.o +0 -0
- data/pkgs/tile-0.8.2/scale.o +0 -0
- data/pkgs/tile-0.8.2/scroll.o +0 -0
- data/pkgs/tile-0.8.2/scrollbar.o +0 -0
- data/pkgs/tile-0.8.2/separator.o +0 -0
- data/pkgs/tile-0.8.2/tagset.o +0 -0
- data/pkgs/tile-0.8.2/tclconfig/install-sh +119 -0
- data/pkgs/tile-0.8.2/tclconfig/tcl.m4 +4069 -0
- data/pkgs/tile-0.8.2/tclconfig/teax.m4 +109 -0
- data/pkgs/tile-0.8.2/tests/all.tcl +18 -0
- data/pkgs/tile-0.8.2/tests/bwidget.test +103 -0
- data/pkgs/tile-0.8.2/tests/cbtest.tcl +125 -0
- data/pkgs/tile-0.8.2/tests/combobox.test +51 -0
- data/pkgs/tile-0.8.2/tests/compound.tcl +92 -0
- data/pkgs/tile-0.8.2/tests/entry.test +285 -0
- data/pkgs/tile-0.8.2/tests/entrytest.tcl +78 -0
- data/pkgs/tile-0.8.2/tests/image.test +94 -0
- data/pkgs/tile-0.8.2/tests/labelframe.tcl +41 -0
- data/pkgs/tile-0.8.2/tests/labelframe.test +137 -0
- data/pkgs/tile-0.8.2/tests/layout.test +33 -0
- data/pkgs/tile-0.8.2/tests/misc.test +35 -0
- data/pkgs/tile-0.8.2/tests/nbtest.tcl +66 -0
- data/pkgs/tile-0.8.2/tests/notebook.test +500 -0
- data/pkgs/tile-0.8.2/tests/paned.test +298 -0
- data/pkgs/tile-0.8.2/tests/progress.test +92 -0
- data/pkgs/tile-0.8.2/tests/pwtest.tcl +90 -0
- data/pkgs/tile-0.8.2/tests/sbtest.tcl +79 -0
- data/pkgs/tile-0.8.2/tests/scrollbar.test +77 -0
- data/pkgs/tile-0.8.2/tests/sgtest.tcl +52 -0
- data/pkgs/tile-0.8.2/tests/testutils.tcl +20 -0
- data/pkgs/tile-0.8.2/tests/tile.test +674 -0
- data/pkgs/tile-0.8.2/tests/treetags.test +78 -0
- data/pkgs/tile-0.8.2/tests/treeview.test +563 -0
- data/pkgs/tile-0.8.2/tests/tvtest.tcl +332 -0
- data/pkgs/tile-0.8.2/tests/validate.test +278 -0
- data/pkgs/tile-0.8.2/tile.o +0 -0
- data/pkgs/tile-0.8.2/tkElements.o +0 -0
- data/pkgs/tile-0.8.2/tkTheme.o +0 -0
- data/pkgs/tile-0.8.2/tkstate.o +0 -0
- data/pkgs/tile-0.8.2/tools/genStubs.tcl +861 -0
- data/pkgs/tile-0.8.2/trace.o +0 -0
- data/pkgs/tile-0.8.2/track.o +0 -0
- data/pkgs/tile-0.8.2/treeview.o +0 -0
- data/pkgs/tile-0.8.2/ttkStubInit.o +0 -0
- data/pkgs/tile-0.8.2/ttkStubLib.o +0 -0
- data/pkgs/tile-0.8.2/widget.o +0 -0
- data/pkgs/tile-0.8.2/win/Tile.dsp +261 -0
- data/pkgs/tile-0.8.2/win/makefile.vc +527 -0
- data/pkgs/tile-0.8.2/win/monitor.c +164 -0
- data/pkgs/tile-0.8.2/win/nmakehlp.c +483 -0
- data/pkgs/tile-0.8.2/win/rules.vc +512 -0
- data/pkgs/tile-0.8.2/win/tile.rc +40 -0
- data/pkgs/tile-0.8.2/win/winTheme.c +734 -0
- data/pkgs/tile-0.8.2/win/xpTheme.c +1029 -0
- data/spec/app_spec.rb +48 -0
- data/spec/customer_spec.rb +31 -0
- data/spec/fixtures/graph.expectation +18 -0
- data/spec/payment_spec.rb +19 -0
- data/spec/pratt_spec.rb +148 -0
- data/spec/project_spec.rb +163 -0
- data/spec/rcov.opts +0 -0
- data/spec/spec.opts +1 -0
- data/spec/spec_helper.rb +21 -0
- data/spec/whence_spec.rb +54 -0
- data/tasks/pratt.rb +84 -0
- data/templates/model.eruby +12 -0
- data/templates/spec.eruby +8 -0
- data/views/env.rb +22 -0
- data/views/graph.eruby +20 -0
- data/views/invoice.eruby +148 -0
- data/views/main.rb +92 -0
- data/views/pid.eruby +3 -0
- data/views/pop.rb +94 -0
- data/views/pop2.rb +75 -0
- data/views/raw.eruby +11 -0
- metadata +390 -0
@@ -0,0 +1,613 @@
|
|
1
|
+
<html>
|
2
|
+
<head>
|
3
|
+
<link rel="stylesheet" href="manpage.css"><title>Tile package reference: entry</title><meta name="xsl-processor" content="Jochen Loewer (loewerj@hotmail.com), Rolf Ade (rolf@pointsman.de) et. al."><meta name="generator" content="$RCSfile: tmml-html.xsl,v $ $Revision: 1.12 $">
|
4
|
+
</head><body>
|
5
|
+
<div class="header">
|
6
|
+
<div class="navbar" align="center">
|
7
|
+
<a href="#SECTid8221fd8">NAME</a> � <a href="#SECTid8222050">SYNOPSIS</a> � <a href="#SECTid8222118">DESCRIPTION</a> � <a href="#SECTid8222230">STANDARD OPTIONS</a> � <a href="#SECTid8222370">WIDGET-SPECIFIC OPTIONS</a> � <a href="#SECTid8222de8">NOTES</a> � <a href="#SECTid8222f50">INDICES</a> � <a href="#SECTid82234c8">WIDGET COMMAND</a> � <a href="#SECTid8224f58">VALIDATION</a> � <a href="#SECTid8202f58">DEFAULT BINDINGS</a> � <a href="#SECTid82032c8">WIDGET STATES</a> � <a href="#SECTid8203548">KEYWORDS</a>
|
8
|
+
</div><hr class="navsep">
|
9
|
+
</div><div class="body">
|
10
|
+
|
11
|
+
|
12
|
+
|
13
|
+
<h2><a name="SECTid8221fd8">NAME</a></h2><p class="namesection">
|
14
|
+
<b class="names">ttk::entry - </b><br>Editable text field widget</p>
|
15
|
+
<h2><a name="SECTid8222050">SYNOPSIS</a></h2><pre class="syntax">
|
16
|
+
<b>ttk::entry</b> <i class="m">pathName</i> ?<i class="m">options</i>?
|
17
|
+
</pre>
|
18
|
+
<h2><a name="SECTid8222118">DESCRIPTION</a></h2><p>An <b>entry</b> widget displays a one-line text string and
|
19
|
+
allows that string to be edited by the user.
|
20
|
+
The value of the string may be linked to a Tcl variable
|
21
|
+
with the <b>-textvariable</b> option.
|
22
|
+
Entry widgets support horizontal scrolling with the
|
23
|
+
standard <b>-xscrollcommand</b> option and <b>xview</b> widget command.
|
24
|
+
</p>
|
25
|
+
<h2><a name="SECTid8222230">STANDARD OPTIONS</a></h2><div class="menu"><table class="menu" width="100%">
|
26
|
+
<tr>
|
27
|
+
<td width="25%"><a href="widget.html#stdopt_-class">-class</a></td><td width="25%"><a href="widget.html#stdopt_-cursor">-cursor</a></td><td width="25%"><a href="widget.html#stdopt_-style">-style</a></td><td width="25%"><a href="widget.html#stdopt_-takefocus">-takefocus</a></td>
|
28
|
+
</tr><tr><td width="25%"><a href="widget.html#stdopt_-xscrollcommand">-xscrollcommand</a></td></tr>
|
29
|
+
</table></div>
|
30
|
+
<h2><a name="SECTid8222370">WIDGET-SPECIFIC OPTIONS</a></h2><div class="table"><table width="100%" rules="none" cellpadding="5%">
|
31
|
+
<thead><tr class="heading">
|
32
|
+
<th width="20%">Name</th><th width="40%">Database name</th><th width="40%">Database class</th>
|
33
|
+
</tr></thead><tr class="syntax">
|
34
|
+
<td width="20%" align="left"><a name="option_-exportselection">-exportselection</a></td><td width="40%" align="left">exportSelection</td><td width="40%" align="left">ExportSelection</td>
|
35
|
+
</tr><tr class="desc">
|
36
|
+
<td class="padding" width="20%">�</td><td class="argdesc" width="80%" align="left" colspan="2">A boolean value specifying whether or not
|
37
|
+
a selection in the widget should be linked to the X selection.
|
38
|
+
If the selection is exported, then selecting in the widget deselects
|
39
|
+
the current X selection, selecting outside the widget deselects any
|
40
|
+
widget selection, and the widget will respond to selection retrieval
|
41
|
+
requests when it has a selection.
|
42
|
+
</td>
|
43
|
+
</tr><tr class="syntax">
|
44
|
+
<td width="20%" align="left"><a name="option_-invalidcommand">-invalidcommand</a></td><td width="40%" align="left">invalidCommand</td><td width="40%" align="left">InvalidCommand</td>
|
45
|
+
</tr><tr class="desc">
|
46
|
+
<td class="padding" width="20%">�</td><td class="argdesc" width="80%" align="left" colspan="2">A script template to evaluate whenever the <b>validateCommand</b> returns 0.
|
47
|
+
See <a href="#SECTid8224f58">VALIDATION</a> below for more information.
|
48
|
+
</td>
|
49
|
+
</tr><tr class="syntax">
|
50
|
+
<td width="20%" align="left"><a name="option_-justify">-justify</a></td><td width="40%" align="left">justify</td><td width="40%" align="left">Justify</td>
|
51
|
+
</tr><tr class="desc">
|
52
|
+
<td class="padding" width="20%">�</td><td class="argdesc" width="80%" align="left" colspan="2">Specifies how the text is aligned within the entry widget.
|
53
|
+
One of <b>left</b>, <b>center</b>, or <b>right</b>.
|
54
|
+
</td>
|
55
|
+
</tr><tr class="syntax">
|
56
|
+
<td width="20%" align="left"><a name="option_-show">-show</a></td><td width="40%" align="left">show</td><td width="40%" align="left">Show</td>
|
57
|
+
</tr><tr class="desc">
|
58
|
+
<td class="padding" width="20%">�</td><td class="argdesc" width="80%" align="left" colspan="2">If this option is specified, then the true contents of the entry
|
59
|
+
are not displayed in the window.
|
60
|
+
Instead, each character in the entry's value will be displayed as
|
61
|
+
the first character in the value of this option, such as ``*''.
|
62
|
+
This is useful, for example, if the entry is to be used to enter
|
63
|
+
a password.
|
64
|
+
If characters in the entry are selected and copied elsewhere, the
|
65
|
+
information copied will be what is displayed, not the true contents
|
66
|
+
of the entry.
|
67
|
+
</td>
|
68
|
+
</tr><tr class="syntax">
|
69
|
+
<td width="20%" align="left"><a name="option_-state">-state</a></td><td width="40%" align="left">state</td><td width="40%" align="left">State</td>
|
70
|
+
</tr><tr class="desc">
|
71
|
+
<td class="padding" width="20%">�</td><td class="argdesc" width="80%" align="left" colspan="2">Compatibility option; see <b>widget(n)</b> for details.
|
72
|
+
Specifies one of three states for the entry,
|
73
|
+
<b>normal</b>, <b>disabled</b>, or <b>readonly</b>.
|
74
|
+
See <a href="#SECTid82032c8">WIDGET STATES</a>, below.
|
75
|
+
</td>
|
76
|
+
</tr><tr class="syntax">
|
77
|
+
<td width="20%" align="left"><a name="option_-textvariable">-textvariable</a></td><td width="40%" align="left">textVariable</td><td width="40%" align="left">Variable</td>
|
78
|
+
</tr><tr class="desc">
|
79
|
+
<td class="padding" width="20%">�</td><td class="argdesc" width="80%" align="left" colspan="2">Specifies the name of a variable whose value is linked
|
80
|
+
to the entry widget's contents.
|
81
|
+
Whenever the variable changes value, the widget's contents are updated,
|
82
|
+
and vice versa.
|
83
|
+
</td>
|
84
|
+
</tr><tr class="syntax">
|
85
|
+
<td width="20%" align="left"><a name="option_-validate">-validate</a></td><td width="40%" align="left">validate</td><td width="40%" align="left">Validate</td>
|
86
|
+
</tr><tr class="desc">
|
87
|
+
<td class="padding" width="20%">�</td><td class="argdesc" width="80%" align="left" colspan="2">Specifies the mode in which validation should operate:
|
88
|
+
<b>none</b>, <b class="cmd">focus</b>, <b>focusin</b>, <b>focusout</b>, <b>key</b>, or <b>all</b>.
|
89
|
+
Default is <b>none</b>, meaning that validation is disabled.
|
90
|
+
See <a href="#SECTid8224f58">VALIDATION</a> below.
|
91
|
+
</td>
|
92
|
+
</tr><tr class="syntax">
|
93
|
+
<td width="20%" align="left"><a name="option_-validatecommand">-validatecommand</a></td><td width="40%" align="left">validateCommand</td><td width="40%" align="left">ValidateCommand</td>
|
94
|
+
</tr><tr class="desc">
|
95
|
+
<td class="padding" width="20%">�</td><td class="argdesc" width="80%" align="left" colspan="2">A script template to evaluate whenever validation is triggered.
|
96
|
+
If set to the empty string (the default), validation is disabled.
|
97
|
+
The script must return a boolean value.
|
98
|
+
See <a href="#SECTid8224f58">VALIDATION</a> below.
|
99
|
+
</td>
|
100
|
+
</tr><tr class="syntax">
|
101
|
+
<td width="20%" align="left"><a name="option_-width">-width</a></td><td width="40%" align="left">width</td><td width="40%" align="left">Width</td>
|
102
|
+
</tr><tr class="desc">
|
103
|
+
<td class="padding" width="20%">�</td><td class="argdesc" width="80%" align="left" colspan="2">Specifies an integer value indicating the desired width of the entry window,
|
104
|
+
in average-size characters of the widget's font.
|
105
|
+
</td>
|
106
|
+
</tr>
|
107
|
+
</table></div>
|
108
|
+
<h2><a name="SECTid8222de8">NOTES</a></h2><p>A portion of the entry may be selected as described below.
|
109
|
+
If an entry is exporting its selection (see the <b>exportSelection</b>
|
110
|
+
option), then it will observe the standard X11 protocols for handling the
|
111
|
+
selection; entry selections are available as type <b>STRING</b>.
|
112
|
+
Entries also observe the standard Tk rules for dealing with the
|
113
|
+
input focus. When an entry has the input focus it displays an
|
114
|
+
<i>insert cursor</i> to indicate where new characters will be
|
115
|
+
inserted.
|
116
|
+
</p><p>Entries are capable of displaying strings that are too long to
|
117
|
+
fit entirely within the widget's window. In this case, only a
|
118
|
+
portion of the string will be displayed; commands described below
|
119
|
+
may be used to change the view in the window. Entries use
|
120
|
+
the standard <b>xScrollCommand</b> mechanism for interacting with
|
121
|
+
scrollbars (see the description of the <b>xScrollCommand</b> option
|
122
|
+
for details).
|
123
|
+
</p>
|
124
|
+
<h2><a name="SECTid8222f50">INDICES</a></h2><p>Many of the <b>entry</b> widget commands take one or more indices as
|
125
|
+
arguments. An index specifies a particular character in the entry's
|
126
|
+
string, in any of the following ways:
|
127
|
+
</p><dl>
|
128
|
+
|
129
|
+
<dt><i class="m">number</i></dt>
|
130
|
+
<dd>Specifies the character as a numerical index, where 0 corresponds
|
131
|
+
to the first character in the string.
|
132
|
+
</dd>
|
133
|
+
|
134
|
+
|
135
|
+
<dt>
|
136
|
+
<b>@</b><i class="m">number</i>
|
137
|
+
</dt>
|
138
|
+
<dd>In this form, <i>number</i> is treated as an x-coordinate in the
|
139
|
+
entry's window; the character spanning that x-coordinate is used.
|
140
|
+
For example, ``<b>@0</b>'' indicates the left-most character in the
|
141
|
+
window.
|
142
|
+
</dd>
|
143
|
+
|
144
|
+
|
145
|
+
<dt><b>end</b></dt>
|
146
|
+
<dd>Indicates the character just after the last one in the entry's string.
|
147
|
+
This is equivalent to specifying a numerical index equal to the length
|
148
|
+
of the entry's string.
|
149
|
+
</dd>
|
150
|
+
|
151
|
+
|
152
|
+
<dt><b>insert</b></dt>
|
153
|
+
<dd>Indicates the character adjacent to and immediately following the
|
154
|
+
insert cursor.
|
155
|
+
</dd>
|
156
|
+
|
157
|
+
|
158
|
+
<dt><b>sel.first</b></dt>
|
159
|
+
<dd>Indicates the first character in the selection. It is an error to
|
160
|
+
use this form if the selection isn't in the entry window.
|
161
|
+
</dd>
|
162
|
+
|
163
|
+
|
164
|
+
<dt><b>sel.last</b></dt>
|
165
|
+
<dd>Indicates the character just after the last one in the selection.
|
166
|
+
It is an error to use this form if the selection isn't in the
|
167
|
+
entry window.
|
168
|
+
</dd>
|
169
|
+
|
170
|
+
</dl><p>Abbreviations may be used for any of the forms above, e.g. ``<b>e</b>''
|
171
|
+
or ``<b>sel.f</b>''. In general, out-of-range indices are automatically
|
172
|
+
rounded to the nearest legal value.
|
173
|
+
</p>
|
174
|
+
<h2><a name="SECTid82234c8">WIDGET COMMAND</a></h2><p>The following commands are possible for entry widgets:
|
175
|
+
</p><dl>
|
176
|
+
|
177
|
+
<dt>
|
178
|
+
<i class="m">pathName</i> <b>bbox</b> <i class="m">index</i>
|
179
|
+
</dt>
|
180
|
+
<dd>Returns a list of four numbers describing the bounding box of the
|
181
|
+
character given by <i>index</i>.
|
182
|
+
The first two elements of the list give the x and y coordinates of
|
183
|
+
the upper-left corner of the screen area covered by the character
|
184
|
+
(in pixels relative to the widget) and the last two elements give
|
185
|
+
the width and height of the character, in pixels.
|
186
|
+
The bounding box may refer to a region outside the visible area
|
187
|
+
of the window.
|
188
|
+
</dd>
|
189
|
+
|
190
|
+
|
191
|
+
<dt>
|
192
|
+
<i class="m">pathName</i> <b>cget</b> <i class="m">option</i>
|
193
|
+
</dt>
|
194
|
+
<dd>Returns the current value of the specified <i>option</i>.
|
195
|
+
See <i>widget(n)</i>.
|
196
|
+
</dd>
|
197
|
+
|
198
|
+
|
199
|
+
<dt>
|
200
|
+
<i class="m">pathName</i> <b>configure</b> ?<i class="m">option</i>? ?<i class="m">value option value ...</i>?</dt>
|
201
|
+
<dd>Modify or query widget options.
|
202
|
+
See <i>widget(n)</i>.
|
203
|
+
</dd>
|
204
|
+
|
205
|
+
|
206
|
+
<dt>
|
207
|
+
<i class="m">pathName</i> <b>delete</b> <i class="m">first</i> ?<i class="m">last</i>?</dt>
|
208
|
+
<dd>Delete one or more elements of the entry.
|
209
|
+
<i>First</i> is the index of the first character to delete, and
|
210
|
+
<i>last</i> is the index of the character just after the last
|
211
|
+
one to delete.
|
212
|
+
If <i>last</i> isn't specified it defaults to <i>first</i>+1,
|
213
|
+
i.e. a single character is deleted.
|
214
|
+
This command returns the empty string.
|
215
|
+
</dd>
|
216
|
+
|
217
|
+
|
218
|
+
<dt>
|
219
|
+
<i class="m">pathName</i> <b>get</b>
|
220
|
+
</dt>
|
221
|
+
<dd>Returns the entry's string.
|
222
|
+
</dd>
|
223
|
+
|
224
|
+
|
225
|
+
<dt>
|
226
|
+
<i class="m">pathName</i> <b>icursor</b> <i class="m">index</i>
|
227
|
+
</dt>
|
228
|
+
<dd>Arrange for the insert cursor to be displayed just before the character
|
229
|
+
given by <i>index</i>. Returns the empty string.
|
230
|
+
</dd>
|
231
|
+
|
232
|
+
|
233
|
+
<dt>
|
234
|
+
<i class="m">pathName</i> <b>identify</b> <i class="m">x y</i>
|
235
|
+
</dt>
|
236
|
+
<dd>Returns the name of the element at position <i>x</i>, <i>y</i>,
|
237
|
+
or the empty string if the coordinates are outside the window.
|
238
|
+
</dd>
|
239
|
+
|
240
|
+
|
241
|
+
<dt>
|
242
|
+
<i class="m">pathName</i> <b>index</b> <i class="m">index</i>
|
243
|
+
</dt>
|
244
|
+
<dd>Returns the numerical index corresponding to <i>index</i>.
|
245
|
+
</dd>
|
246
|
+
|
247
|
+
|
248
|
+
<dt>
|
249
|
+
<i class="m">pathName</i> <b>insert</b> <i class="m">index string</i>
|
250
|
+
</dt>
|
251
|
+
<dd>Insert <i>string</i> just before the character
|
252
|
+
indicated by <i>index</i>. Returns the empty string.
|
253
|
+
</dd>
|
254
|
+
|
255
|
+
|
256
|
+
<dt>
|
257
|
+
<i class="m">pathName</i> <b>instate</b> <i class="m">statespec</i> ?<i class="m">script</i>?</dt>
|
258
|
+
<dd>Test the widget state.
|
259
|
+
See <i>widget(n)</i>.
|
260
|
+
</dd>
|
261
|
+
|
262
|
+
|
263
|
+
<dt>
|
264
|
+
<i class="m">pathName</i> <b>selection</b> <i class="m">option arg</i>
|
265
|
+
</dt>
|
266
|
+
<dd>This command is used to adjust the selection within an entry. It
|
267
|
+
has several forms, depending on <i>option</i>:
|
268
|
+
<dl>
|
269
|
+
|
270
|
+
<dt>
|
271
|
+
<i class="m">pathName</i> <b>selection clear</b>
|
272
|
+
</dt>
|
273
|
+
<dd>Clear the selection if it is currently in this widget.
|
274
|
+
If the selection isn't in this widget then the command has no effect.
|
275
|
+
Returns the empty string.
|
276
|
+
</dd>
|
277
|
+
|
278
|
+
|
279
|
+
<dt>
|
280
|
+
<i class="m">pathName</i> <b>selection present</b>
|
281
|
+
</dt>
|
282
|
+
<dd>Returns 1 if there is are characters selected in the entry,
|
283
|
+
0 if nothing is selected.
|
284
|
+
</dd>
|
285
|
+
|
286
|
+
|
287
|
+
<dt>
|
288
|
+
<i class="m">pathName</i> <b>selection range</b> <i class="m">start</i> <i class="m">end</i>
|
289
|
+
</dt>
|
290
|
+
<dd>Sets the selection to include the characters starting with
|
291
|
+
the one indexed by <i>start</i> and ending with the one just
|
292
|
+
before <i>end</i>.
|
293
|
+
If <i>end</i> refers to the same character as <i>start</i> or an
|
294
|
+
earlier one, then the entry's selection is cleared.
|
295
|
+
</dd>
|
296
|
+
|
297
|
+
</dl>
|
298
|
+
</dd>
|
299
|
+
|
300
|
+
|
301
|
+
<dt>
|
302
|
+
<i class="m">pathName</i> <b>state</b> ?<i class="m">stateSpec</i>?</dt>
|
303
|
+
<dd>Modify or query the widget state.
|
304
|
+
See <i>widget(n)</i>.
|
305
|
+
</dd>
|
306
|
+
|
307
|
+
|
308
|
+
<dt>
|
309
|
+
<i class="m">pathName</i> <b>validate</b>
|
310
|
+
</dt>
|
311
|
+
<dd>Force revalidation, independent of the conditions specified
|
312
|
+
by the <b>-validate</b> option.
|
313
|
+
Returns 0 if validation fails, 1 if it succeeds.
|
314
|
+
Sets or clears the <b>invalid</b> state accordingly.
|
315
|
+
</dd>
|
316
|
+
|
317
|
+
|
318
|
+
<dt>
|
319
|
+
<i class="m">pathName</i> <b>xview</b> <i class="m">args</i>
|
320
|
+
</dt>
|
321
|
+
<dd>This command is used to query and change the horizontal position of the
|
322
|
+
text in the widget's window. It can take any of the following
|
323
|
+
forms:
|
324
|
+
<dl>
|
325
|
+
|
326
|
+
<dt>
|
327
|
+
<i class="m">pathName</i> <b>xview</b>
|
328
|
+
</dt>
|
329
|
+
<dd>Returns a list containing two elements.
|
330
|
+
Each element is a real fraction between 0 and 1; together they describe
|
331
|
+
the horizontal span that is visible in the window.
|
332
|
+
For example, if the first element is .2 and the second element is .6,
|
333
|
+
20% of the entry's text is off-screen to the left, the middle 40% is visible
|
334
|
+
in the window, and 40% of the text is off-screen to the right.
|
335
|
+
These are the same values passed to scrollbars via the <b>-xscrollcommand</b>
|
336
|
+
option.
|
337
|
+
</dd>
|
338
|
+
|
339
|
+
|
340
|
+
<dt>
|
341
|
+
<i class="m">pathName</i> <b>xview</b> <i class="m">index</i>
|
342
|
+
</dt>
|
343
|
+
<dd>Adjusts the view in the window so that the character given by <i>index</i>
|
344
|
+
is displayed at the left edge of the window.
|
345
|
+
</dd>
|
346
|
+
|
347
|
+
|
348
|
+
<dt>
|
349
|
+
<i class="m">pathName</i> <b>xview moveto</b> <i class="m">fraction</i>
|
350
|
+
</dt>
|
351
|
+
<dd>Adjusts the view in the window so that the character <i>fraction</i> of the
|
352
|
+
way through the text appears at the left edge of the window.
|
353
|
+
<i>Fraction</i> must be a fraction between 0 and 1.
|
354
|
+
</dd>
|
355
|
+
|
356
|
+
|
357
|
+
<dt>
|
358
|
+
<i class="m">pathName</i> <b>xview scroll</b> <i class="m">number what</i>
|
359
|
+
</dt>
|
360
|
+
<dd>This command shifts the view in the window left or right according to
|
361
|
+
<i>number</i> and <i>what</i>.
|
362
|
+
<i>Number</i> must be an integer.
|
363
|
+
<i>What</i> must be either <b>units</b> or <b>pages</b>.
|
364
|
+
If <i>what</i> is <b>units</b>, the view adjusts left or right by
|
365
|
+
<i>number</i> average-width characters on the display; if it is
|
366
|
+
<b>pages</b> then the view adjusts by <i>number</i> screenfuls.
|
367
|
+
If <i>number</i> is negative then characters farther to the left
|
368
|
+
become visible; if it is positive then characters farther to the right
|
369
|
+
become visible.
|
370
|
+
</dd>
|
371
|
+
|
372
|
+
</dl>
|
373
|
+
</dd>
|
374
|
+
|
375
|
+
</dl>
|
376
|
+
<h2><a name="SECTid8224f58">VALIDATION</a></h2><p>The <b>-validate</b>, <b>-validatecommand</b>, and <b>-invalidcommand</b>
|
377
|
+
options are used to enable entry widget validation.
|
378
|
+
</p>
|
379
|
+
<h3><a name="SECTid8225048">VALIDATION MODES</a></h3>
|
380
|
+
<p>There are two main validation modes: <i>prevalidation</i>,
|
381
|
+
in which the <b>-validatecommand</b> is evaluated prior to each edit
|
382
|
+
and the return value is used to determine whether to accept
|
383
|
+
or reject the change;
|
384
|
+
and <i>revalidation</i>, in which the <b>-validatecommand</b> is
|
385
|
+
evaluated to determine whether the current value is valid.
|
386
|
+
</p>
|
387
|
+
<p>The <b>-validate</b> option determines when validation occurs;
|
388
|
+
it may be set to any of the following values:
|
389
|
+
</p>
|
390
|
+
<dl>
|
391
|
+
|
392
|
+
<dt><b>none</b></dt>
|
393
|
+
<dd>Default. This means validation will only occur when
|
394
|
+
specifically requested by the <b>validate</b> widget command.
|
395
|
+
</dd>
|
396
|
+
|
397
|
+
|
398
|
+
<dt><b>key</b></dt>
|
399
|
+
<dd>The entry will be prevalidated prior to each edit
|
400
|
+
(specifically, whenever the <b>insert</b> or <b>delete</b>
|
401
|
+
widget commands are called).
|
402
|
+
If prevalidation fails, the edit is rejected.
|
403
|
+
</dd>
|
404
|
+
|
405
|
+
|
406
|
+
<dt><b>focus</b></dt>
|
407
|
+
<dd>The entry is revalidated when the entry receives or loses focus.
|
408
|
+
</dd>
|
409
|
+
|
410
|
+
|
411
|
+
<dt><b>focusin</b></dt>
|
412
|
+
<dd>The entry is revalidated when the entry receives focus.
|
413
|
+
</dd>
|
414
|
+
|
415
|
+
|
416
|
+
<dt><b>focusout</b></dt>
|
417
|
+
<dd>The entry is revalidated when the entry loses focus.
|
418
|
+
</dd>
|
419
|
+
|
420
|
+
|
421
|
+
<dt><b>all</b></dt>
|
422
|
+
<dd>Validation is performed for all above conditions.
|
423
|
+
</dd>
|
424
|
+
|
425
|
+
</dl>
|
426
|
+
<p>The <b>-invalidcommand</b> is evaluated whenever
|
427
|
+
the <b>-validatecommand</b> returns a false value.
|
428
|
+
</p>
|
429
|
+
<p>The <b>-validatecommand</b> and <b>-invalidcommand</b>
|
430
|
+
may modify the entry widget's value
|
431
|
+
via the widget <b>insert</b> or <b>delete</b> commands,
|
432
|
+
or by setting the linked <b>-textvariable</b>.
|
433
|
+
If either does so during prevalidation,
|
434
|
+
then the edit is rejected
|
435
|
+
regardless of the value returned by the <b>-validatecommand</b>.
|
436
|
+
</p>
|
437
|
+
<p>If <b>-validatecommand</b> is empty (the default),
|
438
|
+
validation always succeeds.
|
439
|
+
</p>
|
440
|
+
|
441
|
+
<h3><a name="SECTid8202670">VALIDATION SCRIPT SUBSTITUTIONS</a></h3>
|
442
|
+
<p>It is possible to perform percent substitutions on the
|
443
|
+
<b>-validatecommand</b> and <b>invalidCommand</b>,
|
444
|
+
just as in a <b class="cmd">bind</b> script.
|
445
|
+
The following substitutions are recognized:
|
446
|
+
</p>
|
447
|
+
<dl>
|
448
|
+
|
449
|
+
<dt><b>%d</b></dt>
|
450
|
+
<dd>Type of action: 1 for <b>insert</b> prevalidation,
|
451
|
+
0 for <b>delete</b> prevalidation,
|
452
|
+
or -1 for revalidation.
|
453
|
+
</dd>
|
454
|
+
|
455
|
+
|
456
|
+
<dt><b>%i</b></dt>
|
457
|
+
<dd>Index of character string to be inserted/deleted, if any, otherwise -1.
|
458
|
+
</dd>
|
459
|
+
|
460
|
+
|
461
|
+
<dt><b>%P</b></dt>
|
462
|
+
<dd>In prevalidation, the new value of the entry if the edit is accepted.
|
463
|
+
In revalidation, the current value of the entry.
|
464
|
+
</dd>
|
465
|
+
|
466
|
+
|
467
|
+
<dt><b>%s</b></dt>
|
468
|
+
<dd>The current value of entry prior to editing.
|
469
|
+
</dd>
|
470
|
+
|
471
|
+
|
472
|
+
<dt><b>%S</b></dt>
|
473
|
+
<dd>The text string being inserted/deleted, if any, {} otherwise.
|
474
|
+
</dd>
|
475
|
+
|
476
|
+
|
477
|
+
<dt><b>%v</b></dt>
|
478
|
+
<dd>The current value of the <b>-validate</b> option.
|
479
|
+
</dd>
|
480
|
+
|
481
|
+
|
482
|
+
<dt><b>%V</b></dt>
|
483
|
+
<dd>The validation condition that triggered the callback
|
484
|
+
(<b>key</b>, <b>focusin</b>, <b>focusout</b>, or <b>forced</b>).
|
485
|
+
</dd>
|
486
|
+
|
487
|
+
|
488
|
+
<dt><b>%W</b></dt>
|
489
|
+
<dd>The name of the entry widget.
|
490
|
+
</dd>
|
491
|
+
|
492
|
+
</dl>
|
493
|
+
|
494
|
+
<h3><a name="SECTid8202da0">DIFFERENCES FROM TK ENTRY WIDGET VALIDATION</a></h3>
|
495
|
+
<ul>
|
496
|
+
<li>The standard Tk entry widget automatically disables validation
|
497
|
+
(by setting <b>-validate</b> to <b>none</b>)
|
498
|
+
if the <b>-validatecommand</b> or <b>-invalidcommand</b> modifies
|
499
|
+
the entry's value.
|
500
|
+
The Tile entry widget only disables validation if one
|
501
|
+
of the validation scripts raises an error, or if <b>-validatecommand</b>
|
502
|
+
does not return a valid boolean value.
|
503
|
+
(Thus, it is not necessary to reenable validation after
|
504
|
+
modifying the entry value in a validation script).
|
505
|
+
</li>
|
506
|
+
<li>The standard entry widget invokes validation whenever the linked
|
507
|
+
<b>-textvariable</b> is modified; the Tile entry widget does not.
|
508
|
+
</li>
|
509
|
+
</ul>
|
510
|
+
|
511
|
+
<h2><a name="SECTid8202f58">DEFAULT BINDINGS</a></h2><p>The entry widget's default bindings enable the following behavior.
|
512
|
+
In the descriptions below, ``word'' refers to a contiguous group
|
513
|
+
of letters, digits, or ``_'' characters, or any single character
|
514
|
+
other than these.
|
515
|
+
</p><ul>
|
516
|
+
<li>Clicking mouse button 1 positions the insert cursor
|
517
|
+
just before the character underneath the mouse cursor, sets the
|
518
|
+
input focus to this widget, and clears any selection in the widget.
|
519
|
+
Dragging with mouse button 1 down strokes out a selection between
|
520
|
+
the insert cursor and the character under the mouse.
|
521
|
+
</li>
|
522
|
+
<li>Double-clicking with mouse button 1 selects the word under the mouse
|
523
|
+
and positions the insert cursor at the end of the word.
|
524
|
+
Dragging after a double click strokes out a selection consisting
|
525
|
+
of whole words.
|
526
|
+
</li>
|
527
|
+
<li>Triple-clicking with mouse button 1 selects all of the text in the
|
528
|
+
entry and positions the insert cursor at the end of the line.
|
529
|
+
</li>
|
530
|
+
<li>The ends of the selection can be adjusted by dragging with mouse
|
531
|
+
button 1 while the Shift key is down.
|
532
|
+
If the button is double-clicked before dragging then the selection
|
533
|
+
will be adjusted in units of whole words.
|
534
|
+
</li>
|
535
|
+
<li>Clicking mouse button 1 with the Control key down will position the
|
536
|
+
insert cursor in the entry without affecting the selection.
|
537
|
+
</li>
|
538
|
+
<li>If any normal printing characters are typed in an entry, they are
|
539
|
+
inserted at the point of the insert cursor.
|
540
|
+
</li>
|
541
|
+
<li>The view in the entry can be adjusted by dragging with mouse button 2.
|
542
|
+
If mouse button 2 is clicked without moving the mouse, the selection
|
543
|
+
is copied into the entry at the position of the mouse cursor.
|
544
|
+
</li>
|
545
|
+
<li>If the mouse is dragged out of the entry on the left or right sides
|
546
|
+
while button 1 is pressed, the entry will automatically scroll to
|
547
|
+
make more text visible (if there is more text off-screen on the side
|
548
|
+
where the mouse left the window).
|
549
|
+
</li>
|
550
|
+
<li>The Left and Right keys move the insert cursor one character to the
|
551
|
+
left or right; they also clear any selection in the entry.
|
552
|
+
If Left or Right is typed with the Shift key down, then the insertion
|
553
|
+
cursor moves and the selection is extended to include the new character.
|
554
|
+
Control-Left and Control-Right move the insert cursor by words, and
|
555
|
+
Control-Shift-Left and Control-Shift-Right move the insert cursor
|
556
|
+
by words and also extend the selection.
|
557
|
+
Control-b and Control-f behave the same as Left and Right, respectively.
|
558
|
+
</li>
|
559
|
+
<li>The Home key and Control-a move the insert cursor to the
|
560
|
+
beginning of the entry and clear any selection in the entry.
|
561
|
+
Shift-Home moves the insert cursor to the beginning of the entry
|
562
|
+
and extends the selection to that point.
|
563
|
+
</li>
|
564
|
+
<li>The End key and Control-e move the insert cursor to the
|
565
|
+
end of the entry and clear any selection in the entry.
|
566
|
+
Shift-End moves the cursor to the end and extends the selection
|
567
|
+
to that point.
|
568
|
+
</li>
|
569
|
+
<li>Control-/ selects all the text in the entry.
|
570
|
+
</li>
|
571
|
+
<li>Control-\ clears any selection in the entry.
|
572
|
+
</li>
|
573
|
+
<li>The standard Tk <<Cut>>, <<Copy>>, <<Paste>>, and <<Clear>>
|
574
|
+
virtual events operate on the selection in the expected manner.
|
575
|
+
</li>
|
576
|
+
<li>The Delete key deletes the selection, if there is one in the entry.
|
577
|
+
If there is no selection, it deletes the character to the right of
|
578
|
+
the insert cursor.
|
579
|
+
</li>
|
580
|
+
<li>The BackSpace key and Control-h delete the selection, if there is one
|
581
|
+
in the entry.
|
582
|
+
If there is no selection, it deletes the character to the left of
|
583
|
+
the insert cursor.
|
584
|
+
</li>
|
585
|
+
<li>Control-d deletes the character to the right of the insert cursor.
|
586
|
+
</li>
|
587
|
+
<li>Control-k deletes all the characters to the right of the insertion
|
588
|
+
cursor.
|
589
|
+
</li>
|
590
|
+
</ul>
|
591
|
+
<h2><a name="SECTid82032c8">WIDGET STATES</a></h2><p>In the <b>disabled</b> state,
|
592
|
+
the entry cannot be edited and the text cannot be selected.
|
593
|
+
In the <b>readonly</b> state,
|
594
|
+
no insert cursor is displayed and
|
595
|
+
the entry cannot be edited
|
596
|
+
(specifically: the <b>insert</b> and <b>delete</b> commands have no effect).
|
597
|
+
The <b>disabled</b> state is the same as <b>readonly</b>,
|
598
|
+
and in addition text cannot be selected.
|
599
|
+
</p><p>Note that changes to the linked <b>-textvariable</b> will
|
600
|
+
still be reflected in the entry, even if it is disabled or readonly.
|
601
|
+
</p><p>Typically, the text is "grayed-out" in the <b>disabled</b> state,
|
602
|
+
and a different background is used in the <b>readonly</b> state.
|
603
|
+
</p><p>The entry widget sets the <b>invalid</b> state if revalidation fails,
|
604
|
+
and clears it whenever validation succeeds.
|
605
|
+
</p>
|
606
|
+
<h2><a name="SECTid8203548">KEYWORDS</a></h2><p class="keywords">
|
607
|
+
<a class="keyword" href="keyword-index.html#KW-entry">entry</a>, <a class="keyword" href="keyword-index.html#KW-widget">widget</a>, <a class="keyword" href="keyword-index.html#KW-textfield">text field</a>
|
608
|
+
</p>
|
609
|
+
</div><hr class="navsep"><div class="navbar" align="center">
|
610
|
+
<a class="navaid" href="index.html">Contents</a> � <a class="navaid" href="category-index.html">Index</a> � <a class="navaid" href="keyword-index.html">Keywords</a>
|
611
|
+
</div>
|
612
|
+
</body>
|
613
|
+
</html>
|