Validation
- Preface
- Introduction
- Tutorial
- Implementation
- Commands
- bitmap
- eval-wish
- get-tk-var
- photo
- set-tk-var!
- tk
- tk-id->widget
- tk-var
- tk/after
- tk/appname
- tk/bind
- tk/bindtags
- tk/caret
- tk/choosecolor
- tk/choosedirectory
- tk/clipboard
- tk/console
- tk/destroy
- tk/dialog
- tk/event
- tk/focus
- tk/getopenfile
- tk/getsavefile
- tk/grab
- tk/grid
- tk/image
- tk/lower
- tk/messagebox
- tk/option
- tk/pack
- tk/place
- tk/popup
- tk/raise
- tk/scaling
- tk/update
- tk/useinputmethods
- tk/wait
- tk/windowingsystem
- tk/winfo
- tk/wm
- Options
- Extensions
- Changes
Validation works by setting the validateCommand option to a script which will be evaluated according to the validate option as follows:
- none
- Default. This means no validation will occur.
- focus
- validateCommand will be called when the entry receives or loses focus.
- focusin
- validateCommand will be called when the entry receives focus.
- focusout
- validateCommand will be called when the entry loses focus.
- key
- validateCommand will be called when the entry is edited.
- all
- validateCommand will be called for all above conditions.
It is possible to perform percent substitutions on the validateCommand and invalidCommand, just as you would in a bind script. The following substitutions are recognized:
- %d
- Type of action: 1 for insert, 0 for delete, or -1 for focus, forced or textvariable validation.
- %i
- Index of char string to be inserted/deleted, if any, otherwise -1.
- %P
- The value of the entry should edition occur. If you are configuring the entry widget to have a new textvariable, this will be the value of that textvariable.
- %s
- The current value of entry before edition.
- %S
- The text string being inserted/deleted, if any, {} otherwise.
- %v
- The type of validation currently set.
- %V
- The type of validation that triggered the callback (key, focusin, focusout, forced).
- %W
- The name of the entry widget.