lib/tk8.4/demos/entry3.tcl

   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$
   8
   9 if {![info exists widgetDemo]} {
  10     error "This script should be run from the \"widget\" demo."
  11 }
  12
  13 set w .entry3
  14 catch {destroy $w}
  15 toplevel $w
  16 wm title $w "Constrained Entry Demonstration"
  17 wm iconname $w "entry3"
  18 positionWindow $w
  19
  20
  21 label $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
  35 frame $w.buttons
  36 button $w.buttons.dismiss -text Dismiss -command "destroy $w"
  37 button $w.buttons.code -text "See Code" -command "showCode $w"
  38 pack $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
  53 proc 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
  67 labelframe $w.l1 -text "Integer Entry"
  68 entry $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]"
  71 pack $w.l1.e -fill x -expand 1 -padx 1m -pady 1m
  72
  73 labelframe $w.l2 -text "Length-Constrained Entry"
  74 entry $w.l2.e -validate key -invcmd bell -vcmd {expr {[string length %P]<10}}
  75 pack $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
  82 set 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.
  86 set phoneNumberMap {}
  87 foreach {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
 104 proc 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
 126 proc 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
 148 proc 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
 163 labelframe $w.l3 -text "US Phone-Number Entry"
 164 entry $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...
 167 bind $w.l3.e <FocusIn> {
 168     if {"%d" ne "NotifyAncestor"} {
 169         %W icursor 3
 170         after idle {%W selection clear}
 171     }
 172 }
 173 bind $w.l3.e <Left>  {phoneSkipLeft  %W}
 174 bind $w.l3.e <Right> {phoneSkipRight %W}
 175 pack $w.l3.e -fill x -expand 1 -padx 1m -pady 1m
 176
 177 labelframe $w.l4 -text "Password Entry"
 178 entry $w.l4.e -validate key -show "*" -vcmd {expr {[string length %P]<=8}}
 179 pack $w.l4.e -fill x -expand 1 -padx 1m -pady 1m
 180
 181 lower [frame $w.mid]
 182 grid $w.l1 $w.l2 -in $w.mid -padx 3m -pady 1m -sticky ew
 183 grid $w.l3 $w.l4 -in $w.mid -padx 3m -pady 1m -sticky ew
 184 grid columnconfigure $w.mid {0 1} -uniform 1
 185 pack $w.msg -side top
 186 pack $w.buttons -side bottom -fill x -pady 2m
 187 pack $w.mid -fill both -expand 1