# -*- mode: TCL; fill-column: 75; tab-width: 8; coding: iso-latin-1-unix -*-
#
# $Id: Utils.tcl,v 1.4 2004/03/28 02:44:57 hobbs Exp $
#
# Util.tcl --
#
# The Tix utility commands. Some of these commands are
# replacement of or extensions to the existing TK
# commands. Occasionaly, you have to use the commands inside
# this file instead of thestandard TK commands to make your
# applicatiion work better with Tix. Please read the
# documentations (programmer's guide, man pages) for information
# about these utility commands.
#
# Copyright (c) 1993-1999 Ioi Kim Lam.
# Copyright (c) 2000-2001 Tix Project Group.
# Copyright (c) 2004 ActiveState
#
# See the file "license.terms" for information on usage and redistribution
# of this file, and for a DISCLAIMER OF ALL WARRANTIES.
#
#
# kludge: should be able to handle all kinds of flags
# now only handles "-flag value" pairs.
#
proc tixHandleArgv {p_argv p_options validFlags} {
upvar $p_options opt
upvar $p_argv argv
set old_argv $argv
set argv ""
foreac {flag value} $old_argv {
if {[lsearch $validFlags $flag] != -1} {
# The caller will handle this option exclusively
# It won't be added back to the original arglist
#
eval $opt($flag,action) $value
} else {
# The caller does not handle this option
#
lappend argv $flag
lappend argv $value
}
}
}
#-----------------------------------------------------------------------
# tixDisableAll -
#
# Disable all members in a sub widget tree
#
proc tixDisableAll {w} {
foreach x [tixDescendants $w] {
catch {$x config -state disabled}
}
}
#----------------------------------------------------------------------
# tixEnableAll -
#
# enable all members in a sub widget tree
#
proc tixEnableAll {w} {
foreach x [tixDescendants $w] {
catch {$x config -state normal}
}
}
#----------------------------------------------------------------------
# tixDescendants -
#
# Return a list of all the member of a widget subtree, including
# the tree's root widget.
#
proc tixDescendants {parent} {
set des ""
lappend des $parent
foreach w [winfo children $parent] {
foreach x [tixDescendants $w] {
lappend des $x
}
}
return $des
}
#----------------------------------------------------------------------
# tixTopLevel -
#
# Create a toplevel widget and unmap it immediately. This will ensure
# that this toplevel widgets will not be popped up prematurely when you
# create Tix widgets inside it.
#
# "tixTopLevel" also provide options for you to specify the appearance
# and behavior of this toplevel.
#
#
#
proc tixTopLevel {w args} {
set opt (-geometry) ""
set opt (-minsize) ""
set opt (-maxsize) ""
set opt (-width) ""
set opt (-height) ""
eval [linsert $args 0 toplevel $w]
wm withdraw $w
}
# This is a big kludge
#
# Substitutes all [...] and $.. in the string in $args
#
proc tixInt_Expand {args} {
return $args
}
# Print out all the config options of a widget
#
proc tixPConfig {w} {
puts [join [lsort [$w config]] \n]
}
proc tixAppendBindTag {w tag} {
bindtags $w [concat [bindtags $w] $tag]
}
proc tixAddBindTag {w tag} {
bindtags $w [concat $tag [bindtags $w] ]
}
proc tixSubwidgetRef {sub} {
return $::tixSRef($sub)
}
proc tixSubwidgetRetCreate {sub ref} {
set ::tixSRef($sub) $ref
}
proc tixSubwidgetRetDelete {sub} {
catch {unset ::tixSRef($sub)}
}
proc tixListboxGetCurrent {listbox} {
return [tixEvent flag V]
}
# tixSetMegaWidget --
#
# Associate a subwidget with its mega widget "owner". This is mainly
# used when we add a new bindtag to a subwidget and we need to find out
# the name of the mega widget inside the binding.
#
proc tixSetMegaWidget {w mega {type any}} {
set ::tixMega($type,$w) $mega
}
proc tixGetMegaWidget {w {type any}} {
return $::tixMega($type,$w)
}
proc tixUnsetMegaWidget {w} {
if {[info exists ::tixMega($w)]} { unset ::tixMega($w) }
}
# tixBusy : display busy cursors on a window
#
#
# Should flush the event queue (but not do any idle tasks) before blocking
# the target window (I am not sure if it is aready doing so )
#
# ToDo: should take some additional windows to raise
#
proc tixBusy {w flag {focuswin ""}} {
if {[info command tixInputOnly] == ""} {
return
}
global tixBusy
set toplevel [winfo toplevel $w]
if {![info exists tixBusy(cursor)]} {
set tixBusy(cursor) watch
# set tixBusy(cursor) "[tix getbitmap hourglass] \
# [string range [tix getbitmap hourglass.mask] 1 end]\
# black white"
}
if {$toplevel eq "."} {
set inputonly0 .__tix__busy0
set inputonly1 .__tix__busy1
set inputonly2 .__tix__busy2
set inputonly3 .__tix__busy3
} else {
set inputonly0 $toplevel.__tix__busy0
set inputonly1 $toplevel.__tix__busy1
set inputonly2 $toplevel.__tix__busy2
set inputonly3 $toplevel.__tix__busy3
}
if {![winfo exists $inputonly0]} {
for {set i 0} {$i < 4} {incr i} {
tixInputOnly [set inputonly$i] -cursor $tixBusy(cursor)
}
}
if {$flag eq "on"} {
if {$focuswin != "" && [winfo id $focuswin] != 0} {
if {[info exists tixBusy($focuswin,oldcursor)]} {
return
}
set tixBusy($focuswin,oldcursor) [$focuswin cget -cursor]
$focuswin config -cursor $tixBusy(cursor)
set x1 [expr {[winfo rootx $focuswin]-[winfo rootx $toplevel]}]
set y1 [expr {[winfo rooty $focuswin]-[winfo rooty $toplevel]}]
set W [winfo width $focuswin]
set H [winfo height $focuswin]
set x2 [expr {$x1 + $W}]
set y2 [expr {$y1 + $H}]
if {$y1 > 0} {
tixMoveResizeWindow $inputonly0 0 0 10000 $y1
}
if {$x1 > 0} {
tixMoveResizeWindow $inputonly1 0 0 $x1 10000
}
tixMoveResizeWindow $inputonly2 0 $y2 10000 10000
tixMoveResizeWindow $inputonly3 $x2 0 10000 10000
for {set i 0} {$i < 4} {incr i} {
tixMapWindow [set inputonly$i]
tixRaiseWindow [set inputonly$i]
}
tixFlushX $w
} else {
tixMoveResizeWindow $inputonly0 0 0 10000 10000
tixMapWindow $inputonly0
tixRaiseWindow $inputonly0
}
} else {
tixUnmapWindow $inputonly0
tixUnmapWindow $inputonly1
tixUnmapWindow $inputonly2
tixUnmapWindow $inputonly3
if {$focuswin != "" && [winfo id $focuswin] != 0} {
if {[info exists tixBusy($focuswin,oldcursor)]} {
$focuswin config -cursor $tixBusy($focuswin,oldcursor)
if {[info exists tixBusy($focuswin,oldcursor)]} {
unset tixBusy($focuswin,oldcursor)
}
}
}
}
}
proc tixOptionName {w} {
return [string range $w 1 end]
}
proc tixSetSilent {chooser value} {
$chooser config -disablecallback true
$chooser config -value $value
$chooser config -disablecallback false
}
# This command is useful if you want to ingore the arguments
# passed by the -command or -browsecmd options of the Tix widgets. E.g
#
# tixFileSelectDialog .c -command "puts foo; tixBreak"
#
#
proc tixBreak {args} {}
#----------------------------------------------------------------------
# tixDestroy -- deletes a Tix class object (not widget classes)
#----------------------------------------------------------------------
proc tixDestroy {w} {
upvar #0 $w data
set destructor ""
if {[info exists data(className)]} {
catch {
set destructor [tixGetMethod $w $data(className) Destructor]
}
}
if {$destructor != ""} {
$destructor $w
}
catch {rename $w ""}
catch {unset data}
return ""
}
proc tixPushGrab {args} {
global tix_priv
if {![info exists tix_priv(grab-list)]} {
set tix_priv(grab-list) ""
set tix_priv(grab-mode) ""
set tix_priv(grab-nopush) ""
}
set len [llength $args]
if {$len == 1} {
set opt ""
set w [lindex $args 0]
} elseif {$len == 2} {
set opt [lindex $args 0]
set w [lindex $args 1]
} else {
error "wrong # of arguments: tixPushGrab ?-global? window"
}
# Not everyone will call tixPushGrab. If someone else has a grab already
# save that one as well, so that we can restore that later
#
set last [lindex $tix_priv(grab-list) end]
set current [grab current $w]
if {$current ne "" && $current ne $last} {
# Someone called "grab" directly
#
lappend tix_priv(grab-list) $current
lappend tix_priv(grab-mode) [grab status $current]
lappend tix_priv(grab-nopush) 1
}
# Now push myself into the stack
#
lappend tix_priv(grab-list) $w
lappend tix_priv(grab-mode) $opt
lappend tix_priv(grab-nopush) 0
if {$opt eq "-global"} {
grab -global $w
} else {
grab $w
}
}
proc tixPopGrab {} {
global tix_priv
if {![info exists tix_priv(grab-list)]} {
set tix_priv(grab-list) ""
set tix_priv(grab-mode) ""
set tix_priv(grab-nopush) ""
}
set len [llength $tix_priv(grab-list)]
if {$len <= 0} {
error "no window is grabbed by tixGrab"
}
set w [lindex $tix_priv(grab-list) end]
grab release $w
if {$len > 1} {
set tix_priv(grab-list) [lrange $tix_priv(grab-list) 0 end-1]
set tix_priv(grab-mode) [lrange $tix_priv(grab-mode) 0 end-1]
set tix_priv(grab-nopush) [lrange $tix_priv(grab-nopush) 0 end-1]
set w [lindex $tix_priv(grab-list) end]
set m [lindex $tix_priv(grab-list) end]
set np [lindex $tix_priv(grab-nopush) end]
if {$np == 1} {
# We have a grab set by "grab"
#
set len [llength $tix_priv(grab-list)]
if {$len > 1} {
set tix_priv(grab-list) [lrange $tix_priv(grab-list) 0 end-1]
set tix_priv(grab-mode) [lrange $tix_priv(grab-mode) 0 end-1]
set tix_priv(grab-nopush) \
[lrange $tix_priv(grab-nopush) 0 end-1]
} else {
set tix_priv(grab-list) ""
set tix_priv(grab-mode) ""
set tix_priv(grab-nopush) ""
}
}
if {$m == "-global"} {
grab -global $w
} else {
grab $w
}
} else {
set tix_priv(grab-list) ""
set tix_priv(grab-mode) ""
set tix_priv(grab-nopush) ""
}
}
proc tixWithinWindow {wid rootX rootY} {
set wc [winfo containing $rootX $rootY]
if {$wid eq $wc} { return 1 }
# no see if it is an enclosing parent
set rx1 [winfo rootx $wid]
set ry1 [winfo rooty $wid]
set rw [winfo width $wid]
set rh [winfo height $wid]
set rx2 [expr {$rx1+$rw}]
set ry2 [expr {$ry1+$rh}]
if {$rootX >= $rx1 && $rootX < $rx2 && $rootY >= $ry1 && $rootY < $ry2} {
return 1
} else {
return 0
}
}
proc tixWinWidth {w} {
set W [winfo width $w]
set bd [expr {[$w cget -bd] + [$w cget -highlightthickness]}]
return [expr {$W - 2*$bd}]
}
proc tixWinHeight {w} {
set H [winfo height $w]
set bd [expr {[$w cget -bd] + [$w cget -highlightthickness]}]
return [expr {$H - 2*$bd}]
}
# junk?
#
proc tixWinCmd {w} {
return [winfo command $w]
}
Mini Shell