diff options
author | hobbs <hobbs> | 2006-10-31 01:42:25 (GMT) |
---|---|---|
committer | hobbs <hobbs> | 2006-10-31 01:42:25 (GMT) |
commit | 397a2c9832bf618f26be267501cf49ab06a562ec (patch) | |
tree | 61d5e957eccfcba57b0dd27ebc73db085385834e /library/ttk/keynav.tcl | |
parent | 18d330543869e240c2bd12fc9fbb8d5027f5cad6 (diff) | |
download | tk-397a2c9832bf618f26be267501cf49ab06a562ec.zip tk-397a2c9832bf618f26be267501cf49ab06a562ec.tar.gz tk-397a2c9832bf618f26be267501cf49ab06a562ec.tar.bz2 |
* doc/ttk_Geometry.3, doc/ttk_Theme.3, doc/ttk_button.n:
* doc/ttk_checkbutton.n, doc/ttk_combobox.n, doc/ttk_dialog.n:
* doc/ttk_entry.n, doc/ttk_frame.n, doc/ttk_image.n:
* doc/ttk_intro.n, doc/ttk_label.n, doc/ttk_labelframe.n:
* doc/ttk_menubutton.n, doc/ttk_notebook.n, doc/ttk_panedwindow.n:
* doc/ttk_progressbar.n, doc/ttk_radiobutton.n, doc/ttk_scrollbar.n:
* doc/ttk_separator.n, doc/ttk_sizegrip.n, doc/ttk_style.n:
* doc/ttk_treeview.n, doc/ttk_widget.n,:
* generic/ttk/ttk.decls, generic/ttk/ttkBlink.c:
* generic/ttk/ttkButton.c, generic/ttk/ttkCache.c:
* generic/ttk/ttkClamTheme.c, generic/ttk/ttkClassicTheme.c:
* generic/ttk/ttkDecls.h, generic/ttk/ttkDefaultTheme.c:
* generic/ttk/ttkElements.c, generic/ttk/ttkEntry.c:
* generic/ttk/ttkFrame.c, generic/ttk/ttkImage.c:
* generic/ttk/ttkInit.c, generic/ttk/ttkLabel.c:
* generic/ttk/ttkLayout.c, generic/ttk/ttkManager.c:
* generic/ttk/ttkManager.h, generic/ttk/ttkNotebook.c:
* generic/ttk/ttkPanedwindow.c, generic/ttk/ttkProgress.c:
* generic/ttk/ttkScale.c, generic/ttk/ttkScroll.c:
* generic/ttk/ttkScrollbar.c, generic/ttk/ttkSeparator.c:
* generic/ttk/ttkSquare.c, generic/ttk/ttkState.c:
* generic/ttk/ttkStubInit.c, generic/ttk/ttkStubLib.c:
* generic/ttk/ttkTagSet.c, generic/ttk/ttkTheme.c:
* generic/ttk/ttkTheme.h, generic/ttk/ttkThemeInt.h:
* generic/ttk/ttkTrace.c, generic/ttk/ttkTrack.c:
* generic/ttk/ttkTreeview.c, generic/ttk/ttkWidget.c:
* generic/ttk/ttkWidget.h:
* library/demos/ttk_demo.tcl, library/demos/ttk_iconlib.tcl:
* library/demos/ttk_repeater.tcl:
* library/ttk/altTheme.tcl, library/ttk/aquaTheme.tcl:
* library/ttk/button.tcl, library/ttk/clamTheme.tcl:
* library/ttk/classicTheme.tcl, library/ttk/combobox.tcl:
* library/ttk/cursors.tcl, library/ttk/defaults.tcl:
* library/ttk/dialog.tcl, library/ttk/entry.tcl:
* library/ttk/fonts.tcl, library/ttk/icons.tcl:
* library/ttk/keynav.tcl, library/ttk/menubutton.tcl:
* library/ttk/notebook.tcl, library/ttk/panedwindow.tcl:
* library/ttk/progress.tcl, library/ttk/scale.tcl:
* library/ttk/scrollbar.tcl, library/ttk/sizegrip.tcl:
* library/ttk/treeview.tcl, library/ttk/ttk.tcl:
* library/ttk/utils.tcl, library/ttk/winTheme.tcl:
* library/ttk/xpTheme.tcl:
* macosx/ttkMacOSXTheme.c:
* tests/ttk/all.tcl, tests/ttk/bwidget.test, tests/ttk/combobox.test:
* tests/ttk/entry.test, tests/ttk/image.test:
* tests/ttk/labelframe.test, tests/ttk/layout.test:
* tests/ttk/misc.test, tests/ttk/notebook.test:
* tests/ttk/panedwindow.test, tests/ttk/progressbar.test:
* tests/ttk/scrollbar.test, tests/ttk/treetags.test:
* tests/ttk/treeview.test, tests/ttk/ttk.test, tests/ttk/validate.test:
* win/ttkWinMonitor.c, win/ttkWinTheme.c, win/ttkWinXPTheme.c:
First import of Ttk themed Tk widgets as branched from tile 0.7.8
* generic/tkInt.h, generic/tkWindow.c: add Ttk_Init call, copy
tk classic widgets to ::tk namespace.
* library/tk.tcl: add source of ttk/ttk.tcl, define $::ttk::library.
* unix/Makefile.in, win/Makefile.in: add Ttk build bits
* win/configure, win/configure.in: check for uxtheme.h (XP theme).
Diffstat (limited to 'library/ttk/keynav.tcl')
-rw-r--r-- | library/ttk/keynav.tcl | 163 |
1 files changed, 163 insertions, 0 deletions
diff --git a/library/ttk/keynav.tcl b/library/ttk/keynav.tcl new file mode 100644 index 0000000..090c8f5 --- /dev/null +++ b/library/ttk/keynav.tcl @@ -0,0 +1,163 @@ +######################################################################## +# keynav package - Enhanced keyboard navigation +# Copyright (C) 2003 Joe English +# Freely redistributable; see the file license.terms for details. +# +# $Id: keynav.tcl,v 1.1 2006/10/31 01:42:27 hobbs Exp $ +# +######################################################################## +# +# Usage: +# +# package require keynav +# +# keynav::enableMnemonics $toplevel -- +# Enable mnemonic accelerators for toplevel widget. Pressing Alt-K, +# where K is any alphanumeric key, will send an <<Invoke>> event to the +# widget with mnemonic K (as determined by the -underline and -text +# options). +# +# Side effects: adds a binding for <Alt-KeyPress> to $toplevel +# +# keynav::defaultButton $button -- +# Enables default activation for the toplevel window in which $button +# appears. Pressing <Key-Return> invokes the default widget. The +# default widget is set to the widget with keyboard focus if it is +# defaultable, otherwise $button. A widget is _defaultable_ if it has +# a -default option which is not set to "disabled". +# +# Side effects: adds <FocusIn> and <KeyPress-Return> bindings +# to the toplevel containing $button, and a <Destroy> binding +# to $button. +# +# $button must be a defaultable widget. +# + +namespace eval keynav {} + +package require Tcl 8.4 +package require Tk 8.4 +package provide keynav 1.0 + +event add <<Help>> <KeyPress-F1> + +# +# Bindings for stock Tk widgets: +# (NB: for 8.3 use tkButtonInvoke, tkMbPost instead) +# +bind Button <<Invoke>> { tk::ButtonInvoke %W } +bind Checkbutton <<Invoke>> { tk::ButtonInvoke %W } +bind Radiobutton <<Invoke>> { tk::ButtonInvoke %W } +bind Menubutton <<Invoke>> { tk::MbPost %W } + +proc keynav::enableMnemonics {w} { + bind [winfo toplevel $w] <Alt-KeyPress> {+ keynav::Alt-KeyPress %W %K } +} + +# mnemonic $w -- +# Return the mnemonic character for widget $w, +# as determined by the -text and -underline resources. +# +proc keynav::mnemonic {w} { + if {[catch { + set label [$w cget -text] + set underline [$w cget -underline] + }]} { return "" } + return [string index $label $underline] +} + +# FindMnemonic $w $key -- +# Locate the descendant of $w with mnemonic $key. +# +proc keynav::FindMnemonic {w key} { + if {[string length $key] != 1} { return } + set Q [list [set top [winfo toplevel $w]]] + while {[llength $Q]} { + set QN [list] + foreach w $Q { + if {[string equal -nocase $key [mnemonic $w]]} { + return $w + } + foreach c [winfo children $w] { + if {[winfo ismapped $c] && [winfo toplevel $c] eq $top} { + lappend QN $c + } + } + } + set Q $QN + } + return {} +} + +# Alt-KeyPress -- +# Alt-KeyPress binding for toplevels with mnemonic accelerators enabled. +# +proc keynav::Alt-KeyPress {w k} { + set w [FindMnemonic $w $k] + if {$w ne ""} { + event generate $w <<Invoke>> + return -code break + } +} + +# defaultButton $w -- +# Enable default activation for the toplevel containing $w, +# and make $w the default default widget. +# +proc keynav::defaultButton {w} { + variable DefaultButton + + $w configure -default active + set top [winfo toplevel $w] + set DefaultButton(current.$top) $w + set DefaultButton(default.$top) $w + + bind $w <Destroy> [list keynav::CleanupDefault $top] + bind $top <FocusIn> [list keynav::ClaimDefault $top %W] + bind $top <KeyPress-Return> [list keynav::ActivateDefault $top] +} + +proc keynav::CleanupDefault {top} { + variable DefaultButton + unset DefaultButton(current.$top) + unset DefaultButton(default.$top) +} + +# ClaimDefault $top $w -- +# <FocusIn> binding for default activation. +# Sets the default widget to $w if it is defaultable, +# otherwise set it to the default default. +# +proc keynav::ClaimDefault {top w} { + variable DefaultButton + if {![info exists DefaultButton(current.$top)]} { + # Someone destroyed the default default, but not + # the rest of the toplevel. + return; + } + + set default $DefaultButton(default.$top) + if {![catch {$w cget -default} dstate] && $dstate ne "disabled"} { + set default $w + } + + if {$default ne $DefaultButton(current.$top)} { + # Ignore errors -- someone may have destroyed the current default + catch { $DefaultButton(current.$top) configure -default normal } + $default configure -default active + set DefaultButton(current.$top) $default + } +} + +# ActivateDefault -- +# Invoke the default widget for toplevel window, if any. +# +proc keynav::ActivateDefault {top} { + variable DefaultButton + if {[info exists DefaultButton(current.$top)] + && [winfo exists $DefaultButton(current.$top)]} { + event generate $DefaultButton(current.$top) <<Invoke>> + } +} + +#*EOF* |