+++ /dev/null
-# button.tcl --
-#
-# This file defines the default bindings for Tk label, button,
-# checkbutton, and radiobutton widgets and provides procedures
-# that help in implementing those bindings.
-#
-# Copyright (c) 1992-1994 The Regents of the University of California.
-# Copyright (c) 1994-1996 Sun Microsystems, Inc.
-# Copyright (c) 2002 ActiveState Corporation.
-#
-# See the file "license.terms" for information on usage and redistribution
-# of this file, and for a DISCLAIMER OF ALL WARRANTIES.
-#
-
-#-------------------------------------------------------------------------
-# The code below creates the default class bindings for buttons.
-#-------------------------------------------------------------------------
-
-if {[tk windowingsystem] eq "aqua"} {
-
- bind Radiobutton <Enter> {
- tk::ButtonEnter %W
- }
- bind Radiobutton <1> {
- tk::ButtonDown %W
- }
- bind Radiobutton <ButtonRelease-1> {
- tk::ButtonUp %W
- }
- bind Checkbutton <Enter> {
- tk::ButtonEnter %W
- }
- bind Checkbutton <1> {
- tk::ButtonDown %W
- }
- bind Checkbutton <ButtonRelease-1> {
- tk::ButtonUp %W
- }
- bind Checkbutton <Leave> {
- tk::ButtonLeave %W
- }
-}
-if {"win32" eq [tk windowingsystem]} {
- bind Checkbutton <equal> {
- tk::CheckRadioInvoke %W select
- }
- bind Checkbutton <plus> {
- tk::CheckRadioInvoke %W select
- }
- bind Checkbutton <minus> {
- tk::CheckRadioInvoke %W deselect
- }
- bind Checkbutton <1> {
- tk::CheckRadioDown %W
- }
- bind Checkbutton <ButtonRelease-1> {
- tk::ButtonUp %W
- }
- bind Checkbutton <Enter> {
- tk::CheckRadioEnter %W
- }
- bind Checkbutton <Leave> {
- tk::ButtonLeave %W
- }
-
- bind Radiobutton <1> {
- tk::CheckRadioDown %W
- }
- bind Radiobutton <ButtonRelease-1> {
- tk::ButtonUp %W
- }
- bind Radiobutton <Enter> {
- tk::CheckRadioEnter %W
- }
-}
-if {"x11" eq [tk windowingsystem]} {
- bind Checkbutton <Return> {
- if {!$tk_strictMotif} {
- tk::CheckInvoke %W
- }
- }
- bind Radiobutton <Return> {
- if {!$tk_strictMotif} {
- tk::CheckRadioInvoke %W
- }
- }
- bind Checkbutton <1> {
- tk::CheckInvoke %W
- }
- bind Radiobutton <1> {
- tk::CheckRadioInvoke %W
- }
- bind Checkbutton <Enter> {
- tk::CheckEnter %W
- }
- bind Radiobutton <Enter> {
- tk::ButtonEnter %W
- }
- bind Checkbutton <Leave> {
- tk::CheckLeave %W
- }
-}
-
-bind Button <space> {
- tk::ButtonInvoke %W
-}
-bind Checkbutton <space> {
- tk::CheckRadioInvoke %W
-}
-bind Radiobutton <space> {
- tk::CheckRadioInvoke %W
-}
-bind Button <<Invoke>> {
- tk::ButtonInvoke %W
-}
-bind Checkbutton <<Invoke>> {
- tk::CheckRadioInvoke %W
-}
-bind Radiobutton <<Invoke>> {
- tk::CheckRadioInvoke %W
-}
-
-bind Button <FocusIn> {}
-bind Button <Enter> {
- tk::ButtonEnter %W
-}
-bind Button <Leave> {
- tk::ButtonLeave %W
-}
-bind Button <1> {
- tk::ButtonDown %W
-}
-bind Button <ButtonRelease-1> {
- tk::ButtonUp %W
-}
-
-bind Checkbutton <FocusIn> {}
-
-bind Radiobutton <FocusIn> {}
-bind Radiobutton <Leave> {
- tk::ButtonLeave %W
-}
-
-if {"win32" eq [tk windowingsystem]} {
-
-#########################
-# Windows implementation
-#########################
-
-# ::tk::ButtonEnter --
-# The procedure below is invoked when the mouse pointer enters a
-# button widget. It records the button we're in and changes the
-# state of the button to active unless the button is disabled.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonEnter w {
- variable ::tk::Priv
- if {[$w cget -state] ne "disabled"} {
-
- # If the mouse button is down, set the relief to sunken on entry.
- # Overwise, if there's an -overrelief value, set the relief to that.
-
- set Priv($w,relief) [$w cget -relief]
- if {$Priv(buttonWindow) eq $w} {
- $w configure -relief sunken -state active
- set Priv($w,prelief) sunken
- } elseif {[set over [$w cget -overrelief]] ne ""} {
- $w configure -relief $over
- set Priv($w,prelief) $over
- }
- }
- set Priv(window) $w
-}
-
-# ::tk::ButtonLeave --
-# The procedure below is invoked when the mouse pointer leaves a
-# button widget. It changes the state of the button back to inactive.
-# Restore any modified relief too.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonLeave w {
- variable ::tk::Priv
- if {[$w cget -state] ne "disabled"} {
- $w configure -state normal
- }
-
- # Restore the original button relief if it was changed by Tk.
- # That is signaled by the existence of Priv($w,prelief).
-
- if {[info exists Priv($w,relief)]} {
- if {[info exists Priv($w,prelief)] && \
- $Priv($w,prelief) eq [$w cget -relief]} {
- $w configure -relief $Priv($w,relief)
- }
- unset -nocomplain Priv($w,relief) Priv($w,prelief)
- }
-
- set Priv(window) ""
-}
-
-# ::tk::ButtonDown --
-# The procedure below is invoked when the mouse button is pressed in
-# a button widget. It records the fact that the mouse is in the button,
-# saves the button's relief so it can be restored later, and changes
-# the relief to sunken.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonDown w {
- variable ::tk::Priv
-
- # Only save the button's relief if it does not yet exist. If there
- # is an overrelief setting, Priv($w,relief) will already have been set,
- # and the current value of the -relief option will be incorrect.
-
- if {![info exists Priv($w,relief)]} {
- set Priv($w,relief) [$w cget -relief]
- }
-
- if {[$w cget -state] ne "disabled"} {
- set Priv(buttonWindow) $w
- $w configure -relief sunken -state active
- set Priv($w,prelief) sunken
-
- # If this button has a repeatdelay set up, get it going with an after
- after cancel $Priv(afterId)
- set delay [$w cget -repeatdelay]
- set Priv(repeated) 0
- if {$delay > 0} {
- set Priv(afterId) [after $delay [list tk::ButtonAutoInvoke $w]]
- }
- }
-}
-
-# ::tk::ButtonUp --
-# The procedure below is invoked when the mouse button is released
-# in a button widget. It restores the button's relief and invokes
-# the command as long as the mouse hasn't left the button.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonUp w {
- variable ::tk::Priv
- if {$Priv(buttonWindow) eq $w} {
- set Priv(buttonWindow) ""
-
- # Restore the button's relief if it was cached.
-
- if {[info exists Priv($w,relief)]} {
- if {[info exists Priv($w,prelief)] && \
- $Priv($w,prelief) eq [$w cget -relief]} {
- $w configure -relief $Priv($w,relief)
- }
- unset -nocomplain Priv($w,relief) Priv($w,prelief)
- }
-
- # Clean up the after event from the auto-repeater
- after cancel $Priv(afterId)
-
- if {$Priv(window) eq $w && [$w cget -state] ne "disabled"} {
- $w configure -state normal
-
- # Only invoke the command if it wasn't already invoked by the
- # auto-repeater functionality
- if { $Priv(repeated) == 0 } {
- uplevel #0 [list $w invoke]
- }
- }
- }
-}
-
-# ::tk::CheckRadioEnter --
-# The procedure below is invoked when the mouse pointer enters a
-# checkbutton or radiobutton widget. It records the button we're in
-# and changes the state of the button to active unless the button is
-# disabled.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::CheckRadioEnter w {
- variable ::tk::Priv
- if {[$w cget -state] ne "disabled"} {
- if {$Priv(buttonWindow) eq $w} {
- $w configure -state active
- }
- if {[set over [$w cget -overrelief]] ne ""} {
- set Priv($w,relief) [$w cget -relief]
- set Priv($w,prelief) $over
- $w configure -relief $over
- }
- }
- set Priv(window) $w
-}
-
-# ::tk::CheckRadioDown --
-# The procedure below is invoked when the mouse button is pressed in
-# a button widget. It records the fact that the mouse is in the button,
-# saves the button's relief so it can be restored later, and changes
-# the relief to sunken.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::CheckRadioDown w {
- variable ::tk::Priv
- if {![info exists Priv($w,relief)]} {
- set Priv($w,relief) [$w cget -relief]
- }
- if {[$w cget -state] ne "disabled"} {
- set Priv(buttonWindow) $w
- set Priv(repeated) 0
- $w configure -state active
- }
-}
-
-}
-
-if {"x11" eq [tk windowingsystem]} {
-
-#####################
-# Unix implementation
-#####################
-
-# ::tk::ButtonEnter --
-# The procedure below is invoked when the mouse pointer enters a
-# button widget. It records the button we're in and changes the
-# state of the button to active unless the button is disabled.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonEnter {w} {
- variable ::tk::Priv
- if {[$w cget -state] ne "disabled"} {
- # On unix the state is active just with mouse-over
- $w configure -state active
-
- # If the mouse button is down, set the relief to sunken on entry.
- # Overwise, if there's an -overrelief value, set the relief to that.
-
- set Priv($w,relief) [$w cget -relief]
- if {$Priv(buttonWindow) eq $w} {
- $w configure -relief sunken
- set Priv($w,prelief) sunken
- } elseif {[set over [$w cget -overrelief]] ne ""} {
- $w configure -relief $over
- set Priv($w,prelief) $over
- }
- }
- set Priv(window) $w
-}
-
-# ::tk::ButtonLeave --
-# The procedure below is invoked when the mouse pointer leaves a
-# button widget. It changes the state of the button back to inactive.
-# Restore any modified relief too.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonLeave w {
- variable ::tk::Priv
- if {[$w cget -state] ne "disabled"} {
- $w configure -state normal
- }
-
- # Restore the original button relief if it was changed by Tk.
- # That is signaled by the existence of Priv($w,prelief).
-
- if {[info exists Priv($w,relief)]} {
- if {[info exists Priv($w,prelief)] && \
- $Priv($w,prelief) eq [$w cget -relief]} {
- $w configure -relief $Priv($w,relief)
- }
- unset -nocomplain Priv($w,relief) Priv($w,prelief)
- }
-
- set Priv(window) ""
-}
-
-# ::tk::ButtonDown --
-# The procedure below is invoked when the mouse button is pressed in
-# a button widget. It records the fact that the mouse is in the button,
-# saves the button's relief so it can be restored later, and changes
-# the relief to sunken.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonDown w {
- variable ::tk::Priv
-
- # Only save the button's relief if it does not yet exist. If there
- # is an overrelief setting, Priv($w,relief) will already have been set,
- # and the current value of the -relief option will be incorrect.
-
- if {![info exists Priv($w,relief)]} {
- set Priv($w,relief) [$w cget -relief]
- }
-
- if {[$w cget -state] ne "disabled"} {
- set Priv(buttonWindow) $w
- $w configure -relief sunken
- set Priv($w,prelief) sunken
-
- # If this button has a repeatdelay set up, get it going with an after
- after cancel $Priv(afterId)
- set delay [$w cget -repeatdelay]
- set Priv(repeated) 0
- if {$delay > 0} {
- set Priv(afterId) [after $delay [list tk::ButtonAutoInvoke $w]]
- }
- }
-}
-
-# ::tk::ButtonUp --
-# The procedure below is invoked when the mouse button is released
-# in a button widget. It restores the button's relief and invokes
-# the command as long as the mouse hasn't left the button.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonUp w {
- variable ::tk::Priv
- if {$w eq $Priv(buttonWindow)} {
- set Priv(buttonWindow) ""
-
- # Restore the button's relief if it was cached.
-
- if {[info exists Priv($w,relief)]} {
- if {[info exists Priv($w,prelief)] && \
- $Priv($w,prelief) eq [$w cget -relief]} {
- $w configure -relief $Priv($w,relief)
- }
- unset -nocomplain Priv($w,relief) Priv($w,prelief)
- }
-
- # Clean up the after event from the auto-repeater
- after cancel $Priv(afterId)
-
- if {$Priv(window) eq $w && [$w cget -state] ne "disabled"} {
- # Only invoke the command if it wasn't already invoked by the
- # auto-repeater functionality
- if { $Priv(repeated) == 0 } {
- uplevel #0 [list $w invoke]
- }
- }
- }
-}
-
-}
-
-if {[tk windowingsystem] eq "aqua"} {
-
-####################
-# Mac implementation
-####################
-
-# ::tk::ButtonEnter --
-# The procedure below is invoked when the mouse pointer enters a
-# button widget. It records the button we're in and changes the
-# state of the button to active unless the button is disabled.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonEnter {w} {
- variable ::tk::Priv
- if {[$w cget -state] ne "disabled"} {
-
- # If there's an -overrelief value, set the relief to that.
-
- if {$Priv(buttonWindow) eq $w} {
- $w configure -state active
- } elseif {[set over [$w cget -overrelief]] ne ""} {
- set Priv($w,relief) [$w cget -relief]
- set Priv($w,prelief) $over
- $w configure -relief $over
- }
- }
- set Priv(window) $w
-}
-
-# ::tk::ButtonLeave --
-# The procedure below is invoked when the mouse pointer leaves a
-# button widget. It changes the state of the button back to
-# inactive. If we're leaving the button window with a mouse button
-# pressed (Priv(buttonWindow) == $w), restore the relief of the
-# button too.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonLeave w {
- variable ::tk::Priv
- if {$w eq $Priv(buttonWindow)} {
- $w configure -state normal
- }
-
- # Restore the original button relief if it was changed by Tk.
- # That is signaled by the existence of Priv($w,prelief).
-
- if {[info exists Priv($w,relief)]} {
- if {[info exists Priv($w,prelief)] && \
- $Priv($w,prelief) eq [$w cget -relief]} {
- $w configure -relief $Priv($w,relief)
- }
- unset -nocomplain Priv($w,relief) Priv($w,prelief)
- }
-
- set Priv(window) ""
-}
-
-# ::tk::ButtonDown --
-# The procedure below is invoked when the mouse button is pressed in
-# a button widget. It records the fact that the mouse is in the button,
-# saves the button's relief so it can be restored later, and changes
-# the relief to sunken.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonDown w {
- variable ::tk::Priv
-
- if {[$w cget -state] ne "disabled"} {
- set Priv(buttonWindow) $w
- $w configure -state active
-
- # If this button has a repeatdelay set up, get it going with an after
- after cancel $Priv(afterId)
- set Priv(repeated) 0
- if { ![catch {$w cget -repeatdelay} delay] } {
- if {$delay > 0} {
- set Priv(afterId) [after $delay [list tk::ButtonAutoInvoke $w]]
- }
- }
- }
-}
-
-# ::tk::ButtonUp --
-# The procedure below is invoked when the mouse button is released
-# in a button widget. It restores the button's relief and invokes
-# the command as long as the mouse hasn't left the button.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonUp w {
- variable ::tk::Priv
- if {$Priv(buttonWindow) eq $w} {
- set Priv(buttonWindow) ""
- $w configure -state normal
-
- # Restore the button's relief if it was cached.
-
- if {[info exists Priv($w,relief)]} {
- if {[info exists Priv($w,prelief)] && \
- $Priv($w,prelief) eq [$w cget -relief]} {
- $w configure -relief $Priv($w,relief)
- }
- unset -nocomplain Priv($w,relief) Priv($w,prelief)
- }
-
- # Clean up the after event from the auto-repeater
- after cancel $Priv(afterId)
-
- if {$Priv(window) eq $w && [$w cget -state] ne "disabled"} {
- # Only invoke the command if it wasn't already invoked by the
- # auto-repeater functionality
- if { $Priv(repeated) == 0 } {
- uplevel #0 [list $w invoke]
- }
- }
- }
-}
-
-}
-
-##################
-# Shared routines
-##################
-
-# ::tk::ButtonInvoke --
-# The procedure below is called when a button is invoked through
-# the keyboard. It simulate a press of the button via the mouse.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::ButtonInvoke w {
- if {[winfo exists $w] && [$w cget -state] ne "disabled"} {
- set oldRelief [$w cget -relief]
- set oldState [$w cget -state]
- $w configure -state active -relief sunken
- after 100 [list ::tk::ButtonInvokeEnd $w $oldState $oldRelief]
- }
-}
-
-# ::tk::ButtonInvokeEnd --
-# The procedure below is called after a button is invoked through
-# the keyboard. It simulate a release of the button via the mouse.
-#
-# Arguments:
-# w - The name of the widget.
-# oldState - Old state to be set back.
-# oldRelief - Old relief to be set back.
-
-proc ::tk::ButtonInvokeEnd {w oldState oldRelief} {
- if {[winfo exists $w]} {
- $w configure -state $oldState -relief $oldRelief
- uplevel #0 [list $w invoke]
- }
-}
-
-# ::tk::ButtonAutoInvoke --
-#
-# Invoke an auto-repeating button, and set it up to continue to repeat.
-#
-# Arguments:
-# w button to invoke.
-#
-# Results:
-# None.
-#
-# Side effects:
-# May create an after event to call ::tk::ButtonAutoInvoke.
-
-proc ::tk::ButtonAutoInvoke {w} {
- variable ::tk::Priv
- after cancel $Priv(afterId)
- set delay [$w cget -repeatinterval]
- if {$Priv(window) eq $w} {
- incr Priv(repeated)
- uplevel #0 [list $w invoke]
- }
- if {$delay > 0} {
- set Priv(afterId) [after $delay [list tk::ButtonAutoInvoke $w]]
- }
-}
-
-# ::tk::CheckRadioInvoke --
-# The procedure below is invoked when the mouse button is pressed in
-# a checkbutton or radiobutton widget, or when the widget is invoked
-# through the keyboard. It invokes the widget if it
-# isn't disabled.
-#
-# Arguments:
-# w - The name of the widget.
-# cmd - The subcommand to invoke (one of invoke, select, or deselect).
-
-proc ::tk::CheckRadioInvoke {w {cmd invoke}} {
- if {[$w cget -state] ne "disabled"} {
- uplevel #0 [list $w $cmd]
- }
-}
-
-# Special versions of the handlers for checkbuttons on Unix that do the magic
-# to make things work right when the checkbutton indicator is hidden;
-# radiobuttons don't need this complexity.
-
-# ::tk::CheckInvoke --
-# The procedure below invokes the checkbutton, like ButtonInvoke, but handles
-# what to do when the checkbutton indicator is missing. Only used on Unix.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::CheckInvoke {w} {
- variable ::tk::Priv
- if {[$w cget -state] ne "disabled"} {
- # Additional logic to switch the "selected" colors around if necessary
- # (when we're indicator-less).
-
- if {![$w cget -indicatoron] && [info exist Priv($w,selectcolor)]} {
- if {[$w cget -selectcolor] eq $Priv($w,aselectcolor)} {
- $w configure -selectcolor $Priv($w,selectcolor)
- } else {
- $w configure -selectcolor $Priv($w,aselectcolor)
- }
- }
- uplevel #0 [list $w invoke]
- }
-}
-
-# ::tk::CheckEnter --
-# The procedure below enters the checkbutton, like ButtonEnter, but handles
-# what to do when the checkbutton indicator is missing. Only used on Unix.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::CheckEnter {w} {
- variable ::tk::Priv
- if {[$w cget -state] ne "disabled"} {
- # On unix the state is active just with mouse-over
- $w configure -state active
-
- # If the mouse button is down, set the relief to sunken on entry.
- # Overwise, if there's an -overrelief value, set the relief to that.
-
- set Priv($w,relief) [$w cget -relief]
- if {$Priv(buttonWindow) eq $w} {
- $w configure -relief sunken
- set Priv($w,prelief) sunken
- } elseif {[set over [$w cget -overrelief]] ne ""} {
- $w configure -relief $over
- set Priv($w,prelief) $over
- }
-
- # Compute what the "selected and active" color should be.
-
- if {![$w cget -indicatoron] && [$w cget -selectcolor] ne ""} {
- set Priv($w,selectcolor) [$w cget -selectcolor]
- lassign [winfo rgb $w [$w cget -selectcolor]] r1 g1 b1
- lassign [winfo rgb $w [$w cget -activebackground]] r2 g2 b2
- set Priv($w,aselectcolor) \
- [format "#%04x%04x%04x" [expr {($r1+$r2)/2}] \
- [expr {($g1+$g2)/2}] [expr {($b1+$b2)/2}]]
- # use uplevel to work with other var resolvers
- if {[uplevel #0 [list set [$w cget -variable]]]
- eq [$w cget -onvalue]} {
- $w configure -selectcolor $Priv($w,aselectcolor)
- }
- }
- }
- set Priv(window) $w
-}
-
-# ::tk::CheckLeave --
-# The procedure below leaves the checkbutton, like ButtonLeave, but handles
-# what to do when the checkbutton indicator is missing. Only used on Unix.
-#
-# Arguments:
-# w - The name of the widget.
-
-proc ::tk::CheckLeave {w} {
- variable ::tk::Priv
- if {[$w cget -state] ne "disabled"} {
- $w configure -state normal
- }
-
- # Restore the original button "selected" color; assume that the user
- # wasn't monkeying around with things too much.
-
- if {![$w cget -indicatoron] && [info exist Priv($w,selectcolor)]} {
- $w configure -selectcolor $Priv($w,selectcolor)
- }
- unset -nocomplain Priv($w,selectcolor) Priv($w,aselectcolor)
-
- # Restore the original button relief if it was changed by Tk. That is
- # signaled by the existence of Priv($w,prelief).
-
- if {[info exists Priv($w,relief)]} {
- if {[info exists Priv($w,prelief)] && \
- $Priv($w,prelief) eq [$w cget -relief]} {
- $w configure -relief $Priv($w,relief)
- }
- unset -nocomplain Priv($w,relief) Priv($w,prelief)
- }
-
- set Priv(window) ""
-}
-
-return
-\f
-# Local Variables:
-# mode: tcl
-# fill-column: 78
-# End: