1# entry2.tcl -- 2# 3# This demonstration script creates several entry widgets whose 4# permitted input is constrained in some way. It also shows off a 5# password entry. 6# 7# RCS: @(#) $Id: entry3.tcl,v 1.1 2001/11/19 14:02:29 dkf Exp $ 8 9if {![info exists widgetDemo]} { 10 error "This script should be run from the \"widget\" demo." 11} 12 13set w .entry3 14catch {destroy $w} 15toplevel $w 16wm title $w "Constrained Entry Demonstration" 17wm iconname $w "entry3" 18positionWindow $w 19 20 21label $w.msg -font $font -wraplength 5i -justify left -text "Four different\ 22 entries are displayed below. You can add characters by pointing,\ 23 clicking and typing, though each is constrained in what it will\ 24 accept. The first only accepts integers or the empty string\ 25 (checking when focus leaves it) and will flash to indicate any\ 26 problem. The second only accepts strings with fewer than ten\ 27 characters and sounds the bell when an attempt to go over the limit\ 28 is made. The third accepts US phone numbers, mapping letters to\ 29 their digit equivalent and sounding the bell on encountering an\ 30 illegal character or if trying to type over a character that is not\ 31 a digit. The fourth is a password field that accepts up to eight\ 32 characters (silently ignoring further ones), and displaying them as\ 33 asterisk characters." 34 35frame $w.buttons 36button $w.buttons.dismiss -text Dismiss -command "destroy $w" 37button $w.buttons.code -text "See Code" -command "showCode $w" 38pack $w.buttons.dismiss $w.buttons.code -side left -expand 1 39 40 41# focusAndFlash -- 42# Error handler for entry widgets that forces the focus onto the 43# widget and makes the widget flash by exchanging the foreground and 44# background colours at intervals of 200ms (i.e. at approximately 45# 2.5Hz). 46# 47# Arguments: 48# W - Name of entry widget to flash 49# fg - Initial foreground colour 50# bg - Initial background colour 51# count - Counter to control the number of times flashed 52 53proc focusAndFlash {W fg bg {count 9}} { 54 focus -force $W 55 if {$count<1} { 56 $W configure -foreground $fg -background $bg 57 } else { 58 if {$count%2} { 59 $W configure -foreground $bg -background $fg 60 } else { 61 $W configure -foreground $fg -background $bg 62 } 63 after 200 [list focusAndFlash $W $fg $bg [expr {$count-1}]] 64 } 65} 66 67labelframe $w.l1 -text "Integer Entry" 68entry $w.l1.e -validate focus -vcmd {string is integer %P} 69$w.l1.e configure -invalidcommand \ 70 "focusAndFlash %W [$w.l1.e cget -fg] [$w.l1.e cget -bg]" 71pack $w.l1.e -fill x -expand 1 -padx 1m -pady 1m 72 73labelframe $w.l2 -text "Length-Constrained Entry" 74entry $w.l2.e -validate key -invcmd bell -vcmd {expr {[string length %P]<10}} 75pack $w.l2.e -fill x -expand 1 -padx 1m -pady 1m 76 77### PHONE NUMBER ENTRY ### 78# Note that the source to this is quite a bit longer as the behaviour 79# demonstrated is a lot more ambitious than with the others. 80 81# Initial content for the third entry widget 82set entry3content "1-(000)-000-0000" 83# Mapping from alphabetic characters to numbers. This is probably 84# wrong, but it is the only mapping I have; the UK doesn't really go 85# for associating letters with digits for some reason. 86set phoneNumberMap {} 87foreach {chars digit} {abc 2 def 3 ghi 4 jkl 5 mno 6 pqrs 7 tuv 8 wxyz 9} { 88 foreach char [split $chars ""] { 89 lappend phoneNumberMap $char $digit [string toupper $char] $digit 90 } 91} 92 93# validatePhoneChange -- 94# Checks that the replacement (mapped to a digit) of the given 95# character in an entry widget at the given position will leave a 96# valid phone number in the widget. 97# 98# W - The entry widget to validate 99# vmode - The widget's validation mode 100# idx - The index where replacement is to occur 101# char - The character (or string, though that will always be 102# refused) to be overwritten at that point. 103 104proc validatePhoneChange {W vmode idx char} { 105 global phoneNumberMap entry3content 106 if {$idx == -1} {return 1} 107 after idle [list $W configure -validate $vmode -invcmd bell] 108 if { 109 !($idx<3 || $idx==6 || $idx==7 || $idx==11 || $idx>15) && 110 [string match {[0-9A-Za-z]} $char] 111 } then { 112 $W delete $idx 113 $W insert $idx [string map $phoneNumberMap $char] 114 after idle [list phoneSkipRight $W -1] 115 return 1 116 } 117 return 0 118} 119 120# phoneSkipLeft -- 121# Skip over fixed characters in a phone-number string when moving left. 122# 123# Arguments: 124# W - The entry widget containing the phone-number. 125 126proc phoneSkipLeft {W} { 127 set idx [$W index insert] 128 if {$idx == 8} { 129 # Skip back two extra characters 130 $W icursor [incr idx -2] 131 } elseif {$idx == 7 || $idx == 12} { 132 # Skip back one extra character 133 $W icursor [incr idx -1] 134 } elseif {$idx <= 3} { 135 # Can't move any further 136 bell 137 return -code break 138 } 139} 140 141# phoneSkipRight -- 142# Skip over fixed characters in a phone-number string when moving right. 143# 144# Arguments: 145# W - The entry widget containing the phone-number. 146# add - Offset to add to index before calculation (used by validation.) 147 148proc phoneSkipRight {W {add 0}} { 149 set idx [$W index insert] 150 if {$idx+$add == 5} { 151 # Skip forward two extra characters 152 $W icursor [incr idx 2] 153 } elseif {$idx+$add == 6 || $idx+$add == 10} { 154 # Skip forward one extra character 155 $W icursor [incr idx] 156 } elseif {$idx+$add == 15 && !$add} { 157 # Can't move any further 158 bell 159 return -code break 160 } 161} 162 163labelframe $w.l3 -text "US Phone-Number Entry" 164entry $w.l3.e -validate key -invcmd bell -textvariable entry3content \ 165 -vcmd {validatePhoneChange %W %v %i %S} 166# Click to focus goes to the first editable character... 167bind $w.l3.e <FocusIn> { 168 if {"%d" ne "NotifyAncestor"} { 169 %W icursor 3 170 after idle {%W selection clear} 171 } 172} 173bind $w.l3.e <Left> {phoneSkipLeft %W} 174bind $w.l3.e <Right> {phoneSkipRight %W} 175pack $w.l3.e -fill x -expand 1 -padx 1m -pady 1m 176 177labelframe $w.l4 -text "Password Entry" 178entry $w.l4.e -validate key -show "*" -vcmd {expr {[string length %P]<=8}} 179pack $w.l4.e -fill x -expand 1 -padx 1m -pady 1m 180 181lower [frame $w.mid] 182grid $w.l1 $w.l2 -in $w.mid -padx 3m -pady 1m -sticky ew 183grid $w.l3 $w.l4 -in $w.mid -padx 3m -pady 1m -sticky ew 184grid columnconfigure $w.mid {0 1} -uniform 1 185pack $w.msg -side top 186pack $w.buttons -side bottom -fill x -pady 2m 187pack $w.mid -fill both -expand 1 188