# Spinint
|
# Spinint
|
# ----------------------------------------------------------------------
|
# ----------------------------------------------------------------------
|
# Implements an integer spinner widget. It inherits basic spinner
|
# Implements an integer spinner widget. It inherits basic spinner
|
# functionality from Spinner and adds specific features to create
|
# functionality from Spinner and adds specific features to create
|
# an integer-only spinner.
|
# an integer-only spinner.
|
# Arrows may be placed horizontally or vertically.
|
# Arrows may be placed horizontally or vertically.
|
# User may specify an integer range and step value.
|
# User may specify an integer range and step value.
|
# Spinner may be configured to wrap when min or max value is reached.
|
# Spinner may be configured to wrap when min or max value is reached.
|
#
|
#
|
# NOTE:
|
# NOTE:
|
# Spinint integer values should not exceed the size of a long integer.
|
# Spinint integer values should not exceed the size of a long integer.
|
# For a 32 bit long the integer range is -2147483648 to 2147483647.
|
# For a 32 bit long the integer range is -2147483648 to 2147483647.
|
#
|
#
|
# ----------------------------------------------------------------------
|
# ----------------------------------------------------------------------
|
# AUTHOR: Sue Yockey Phone: (214) 519-2517
|
# AUTHOR: Sue Yockey Phone: (214) 519-2517
|
# E-mail: syockey@spd.dsccc.com
|
# E-mail: syockey@spd.dsccc.com
|
# yockey@acm.org
|
# yockey@acm.org
|
#
|
#
|
# @(#) $Id: spinint.itk,v 1.1.1.1 2002-01-16 10:24:50 markom Exp $
|
# @(#) $Id: spinint.itk,v 1.1.1.1 2002-01-16 10:24:50 markom Exp $
|
# ----------------------------------------------------------------------
|
# ----------------------------------------------------------------------
|
# Copyright (c) 1995 DSC Technologies Corporation
|
# Copyright (c) 1995 DSC Technologies Corporation
|
# ======================================================================
|
# ======================================================================
|
# Permission to use, copy, modify, distribute and license this software
|
# Permission to use, copy, modify, distribute and license this software
|
# and its documentation for any purpose, and without fee or written
|
# and its documentation for any purpose, and without fee or written
|
# agreement with DSC, is hereby granted, provided that the above copyright
|
# agreement with DSC, is hereby granted, provided that the above copyright
|
# notice appears in all copies and that both the copyright notice and
|
# notice appears in all copies and that both the copyright notice and
|
# warranty disclaimer below appear in supporting documentation, and that
|
# warranty disclaimer below appear in supporting documentation, and that
|
# the names of DSC Technologies Corporation or DSC Communications
|
# the names of DSC Technologies Corporation or DSC Communications
|
# Corporation not be used in advertising or publicity pertaining to the
|
# Corporation not be used in advertising or publicity pertaining to the
|
# software without specific, written prior permission.
|
# software without specific, written prior permission.
|
#
|
#
|
# DSC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
|
# DSC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
|
# ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, AND NON-
|
# ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, AND NON-
|
# INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND THE
|
# INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND THE
|
# AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE,
|
# AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE,
|
# SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. IN NO EVENT SHALL
|
# SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. IN NO EVENT SHALL
|
# DSC BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
|
# DSC BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
|
# ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
|
# ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
|
# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTUOUS ACTION,
|
# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTUOUS ACTION,
|
# ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
|
# ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
|
# SOFTWARE.
|
# SOFTWARE.
|
# ======================================================================
|
# ======================================================================
|
|
|
#
|
#
|
# Usual options.
|
# Usual options.
|
#
|
#
|
itk::usual Spinint {
|
itk::usual Spinint {
|
keep -background -borderwidth -cursor -foreground -highlightcolor \
|
keep -background -borderwidth -cursor -foreground -highlightcolor \
|
-highlightthickness -insertbackground -insertborderwidth \
|
-highlightthickness -insertbackground -insertborderwidth \
|
-insertofftime -insertontime -insertwidth -labelfont \
|
-insertofftime -insertontime -insertwidth -labelfont \
|
-selectbackground -selectborderwidth -selectforeground \
|
-selectbackground -selectborderwidth -selectforeground \
|
-textbackground -textfont
|
-textbackground -textfont
|
}
|
}
|
|
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
# SPININT
|
# SPININT
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
class iwidgets::Spinint {
|
class iwidgets::Spinint {
|
inherit iwidgets::Spinner
|
inherit iwidgets::Spinner
|
|
|
constructor {args} {
|
constructor {args} {
|
Spinner::constructor -validate numeric
|
Spinner::constructor -validate numeric
|
} {}
|
} {}
|
|
|
itk_option define -range range Range ""
|
itk_option define -range range Range ""
|
itk_option define -step step Step 1
|
itk_option define -step step Step 1
|
itk_option define -wrap wrap Wrap true
|
itk_option define -wrap wrap Wrap true
|
|
|
public method up {}
|
public method up {}
|
public method down {}
|
public method down {}
|
}
|
}
|
|
|
#
|
#
|
# Provide a lowercased access method for the Spinint class.
|
# Provide a lowercased access method for the Spinint class.
|
#
|
#
|
proc ::iwidgets::spinint {pathName args} {
|
proc ::iwidgets::spinint {pathName args} {
|
uplevel ::iwidgets::Spinint $pathName $args
|
uplevel ::iwidgets::Spinint $pathName $args
|
}
|
}
|
|
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
# CONSTRUCTOR
|
# CONSTRUCTOR
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
body iwidgets::Spinint::constructor {args} {
|
body iwidgets::Spinint::constructor {args} {
|
eval itk_initialize $args
|
eval itk_initialize $args
|
|
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) delete 0 end
|
|
|
if {[lindex $itk_option(-range) 0] == ""} {
|
if {[lindex $itk_option(-range) 0] == ""} {
|
$itk_component(entry) insert 0 "0"
|
$itk_component(entry) insert 0 "0"
|
} else {
|
} else {
|
$itk_component(entry) insert 0 [lindex $itk_option(-range) 0]
|
$itk_component(entry) insert 0 [lindex $itk_option(-range) 0]
|
}
|
}
|
}
|
}
|
|
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
# OPTIONS
|
# OPTIONS
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
|
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
# OPTION: -range
|
# OPTION: -range
|
#
|
#
|
# Set min and max values for spinner.
|
# Set min and max values for spinner.
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
configbody iwidgets::Spinint::range {
|
configbody iwidgets::Spinint::range {
|
if {$itk_option(-range) != ""} {
|
if {$itk_option(-range) != ""} {
|
if {[llength $itk_option(-range)] != 2} {
|
if {[llength $itk_option(-range)] != 2} {
|
error "wrong # args: should be\
|
error "wrong # args: should be\
|
\"$itk_component(hull) configure -range {begin end}\""
|
\"$itk_component(hull) configure -range {begin end}\""
|
}
|
}
|
|
|
set min [lindex $itk_option(-range) 0]
|
set min [lindex $itk_option(-range) 0]
|
set max [lindex $itk_option(-range) 1]
|
set max [lindex $itk_option(-range) 1]
|
|
|
if {![regexp {^-?[0-9]+$} $min]} {
|
if {![regexp {^-?[0-9]+$} $min]} {
|
error "bad range option \"$min\": begin value must be\
|
error "bad range option \"$min\": begin value must be\
|
an integer"
|
an integer"
|
}
|
}
|
if {![regexp {^-?[0-9]+$} $max]} {
|
if {![regexp {^-?[0-9]+$} $max]} {
|
error "bad range option \"$max\": end value must be\
|
error "bad range option \"$max\": end value must be\
|
an integer"
|
an integer"
|
}
|
}
|
if {$min > $max} {
|
if {$min > $max} {
|
error "bad option starting range \"$min\": must be less\
|
error "bad option starting range \"$min\": must be less\
|
than ending: \"$max\""
|
than ending: \"$max\""
|
}
|
}
|
}
|
}
|
}
|
}
|
|
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
# OPTION: -step
|
# OPTION: -step
|
#
|
#
|
# Increment spinner by step value.
|
# Increment spinner by step value.
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
configbody iwidgets::Spinint::step {
|
configbody iwidgets::Spinint::step {
|
}
|
}
|
|
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
# OPTION: -wrap
|
# OPTION: -wrap
|
#
|
#
|
# Specify whether spinner should wrap value if at min or max.
|
# Specify whether spinner should wrap value if at min or max.
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
configbody iwidgets::Spinint::wrap {
|
configbody iwidgets::Spinint::wrap {
|
}
|
}
|
|
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
# METHODS
|
# METHODS
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
|
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
# METHOD: up
|
# METHOD: up
|
#
|
#
|
# Up arrow button press event. Increment value in entry.
|
# Up arrow button press event. Increment value in entry.
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
body iwidgets::Spinint::up {} {
|
body iwidgets::Spinint::up {} {
|
set min_range [lindex $itk_option(-range) 0]
|
set min_range [lindex $itk_option(-range) 0]
|
set max_range [lindex $itk_option(-range) 1]
|
set max_range [lindex $itk_option(-range) 1]
|
|
|
set val [$itk_component(entry) get]
|
set val [$itk_component(entry) get]
|
if {[lindex $itk_option(-range) 0] != ""} {
|
if {[lindex $itk_option(-range) 0] != ""} {
|
|
|
#
|
#
|
# Check boundaries.
|
# Check boundaries.
|
#
|
#
|
if {$val >= $min_range && $val < $max_range} {
|
if {$val >= $min_range && $val < $max_range} {
|
incr val $itk_option(-step)
|
incr val $itk_option(-step)
|
|
|
#
|
#
|
# Re-check boundaries.
|
# Re-check boundaries.
|
#
|
#
|
if {$val >= $min_range && $val <= $max_range} {
|
if {$val >= $min_range && $val <= $max_range} {
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) insert 0 $val
|
$itk_component(entry) insert 0 $val
|
} else {
|
} else {
|
|
|
#
|
#
|
# This is wrap when -step > 1.
|
# This is wrap when -step > 1.
|
#
|
#
|
if {$itk_option(-wrap)} {
|
if {$itk_option(-wrap)} {
|
if {$val > $max_range} {
|
if {$val > $max_range} {
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) insert 0 $min_range
|
$itk_component(entry) insert 0 $min_range
|
} else {
|
} else {
|
uplevel #0 $itk_option(-invalid)
|
uplevel #0 $itk_option(-invalid)
|
}
|
}
|
} else {
|
} else {
|
uplevel #0 $itk_option(-invalid)
|
uplevel #0 $itk_option(-invalid)
|
}
|
}
|
}
|
}
|
|
|
} else {
|
} else {
|
if {$itk_option(-wrap)} {
|
if {$itk_option(-wrap)} {
|
if {$val == $max_range} {
|
if {$val == $max_range} {
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) insert 0 $min_range
|
$itk_component(entry) insert 0 $min_range
|
} else {
|
} else {
|
uplevel #0 $itk_option(-invalid)
|
uplevel #0 $itk_option(-invalid)
|
}
|
}
|
} else {
|
} else {
|
uplevel #0 $itk_option(-invalid)
|
uplevel #0 $itk_option(-invalid)
|
}
|
}
|
}
|
}
|
} else {
|
} else {
|
|
|
#
|
#
|
# No boundaries.
|
# No boundaries.
|
#
|
#
|
incr val $itk_option(-step)
|
incr val $itk_option(-step)
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) insert 0 $val
|
$itk_component(entry) insert 0 $val
|
}
|
}
|
}
|
}
|
|
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
# METHOD: down
|
# METHOD: down
|
#
|
#
|
# Down arrow button press event. Decrement value in entry.
|
# Down arrow button press event. Decrement value in entry.
|
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
body iwidgets::Spinint::down {} {
|
body iwidgets::Spinint::down {} {
|
set min_range [lindex $itk_option(-range) 0]
|
set min_range [lindex $itk_option(-range) 0]
|
set max_range [lindex $itk_option(-range) 1]
|
set max_range [lindex $itk_option(-range) 1]
|
|
|
set val [$itk_component(entry) get]
|
set val [$itk_component(entry) get]
|
if {[lindex $itk_option(-range) 0] != ""} {
|
if {[lindex $itk_option(-range) 0] != ""} {
|
|
|
#
|
#
|
# Check boundaries.
|
# Check boundaries.
|
#
|
#
|
if {$val > $min_range && $val <= $max_range} {
|
if {$val > $min_range && $val <= $max_range} {
|
incr val -$itk_option(-step)
|
incr val -$itk_option(-step)
|
|
|
#
|
#
|
# Re-check boundaries.
|
# Re-check boundaries.
|
#
|
#
|
if {$val >= $min_range && $val <= $max_range} {
|
if {$val >= $min_range && $val <= $max_range} {
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) insert 0 $val
|
$itk_component(entry) insert 0 $val
|
} else {
|
} else {
|
|
|
#
|
#
|
# This is wrap when -step > 1.
|
# This is wrap when -step > 1.
|
#
|
#
|
if {$itk_option(-wrap)} {
|
if {$itk_option(-wrap)} {
|
if {$val < $min_range} {
|
if {$val < $min_range} {
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) insert 0 $max_range
|
$itk_component(entry) insert 0 $max_range
|
} else {
|
} else {
|
uplevel #0 $itk_option(-invalid)
|
uplevel #0 $itk_option(-invalid)
|
}
|
}
|
} else {
|
} else {
|
uplevel #0 $itk_option(-invalid)
|
uplevel #0 $itk_option(-invalid)
|
}
|
}
|
}
|
}
|
|
|
} else {
|
} else {
|
if {$itk_option(-wrap)} {
|
if {$itk_option(-wrap)} {
|
if {$val == $min_range} {
|
if {$val == $min_range} {
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) insert 0 $max_range
|
$itk_component(entry) insert 0 $max_range
|
} else {
|
} else {
|
uplevel #0 $itk_option(-invalid)
|
uplevel #0 $itk_option(-invalid)
|
}
|
}
|
} else {
|
} else {
|
uplevel #0 $itk_option(-invalid)
|
uplevel #0 $itk_option(-invalid)
|
}
|
}
|
}
|
}
|
} else {
|
} else {
|
|
|
#
|
#
|
# No boundaries.
|
# No boundaries.
|
#
|
#
|
incr val -$itk_option(-step)
|
incr val -$itk_option(-step)
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) delete 0 end
|
$itk_component(entry) insert 0 $val
|
$itk_component(entry) insert 0 $val
|
}
|
}
|
}
|
}
|
|
|
