Provided by: tklib_0.9-1_all 
NAME
tipstack - Stacked tooltips
SYNOPSIS
package require Tcl 8.5
package require msgcat 1.3
package require tooltip ?1.7?
package require tipstack ?1.0.1?
::tipstack::push widget ?-index index? text
::tipstack::pop widget ?-index index?
::tipstack::clear widget ?-index index?
::tipstack::def widget text ...
::tipstack::defsub base widget text ...
::tipstack::clearsub base
________________________________________________________________________________________________________________
DESCRIPTION
This package extends the functionality of package tooltip. It provides a dynamic stack of tip texts per
widget. This enables dynamic transient changes to the tips, for example to temporarily replace a standard
explanation of a field with an error message.
COMMANDS
::tipstack::push widget ?-index index? text
Push a new text to the tooltip for the widget. In case of a list widget use
-index ...
to tooltip for.
The result of the command is the empty string
::tipstack::pop widget ?-index index?
Pop the current tooltip for the widget from the stack and restore the previous text. This is a
no-operation if this would leave an empty stack behind. In other words, the baseline tooltip text
cannot be popped of. In case of a list widget use
-index ...
to tooltip for.
The result of the command is the empty string
::tipstack::clear widget ?-index index?
Clear the stack for the widget and restore back to the baseline. In case of a list widget use
-index ...
to tooltip for.
The result of the command is the empty string
::tipstack::def widget text ...
Perform multiple pushes for a number of independent widgets in a single call. This command cannot
be used for list widgets, as it does not allow the passing of the necessary index information.
Use with menus is not possible either.
The result of the command is the empty string
::tipstack::defsub base widget text ...
This command is a variant of ::tipstack::def where all the widgets to push to are subwidgets of
the base. This is good for mega-widgets.
Note that either each widget has to be specified with a proper leading dot (.), or the base has to
be specigfied with a trailing dot.
The result of the command is the empty string
::tipstack::clearsub base
This command is a variant of ::tipstack::clear which clears all child widgets of the base text was
pushed to. Use with menus is not possible.
The result of the command is the empty string
BUGS, IDEAS, FEEDBACK
This document, and the package it describes, will undoubtedly contain bugs and other problems. Please
report such in the category tooltip of the Tklib Trackers [http://core.tcl.tk/tklib/reportlist]. Please
also report any ideas for enhancements you may have for either package and/or documentation.
KEYWORDS
balloon, help, hover, tipstack
COPYRIGHT
Copyright (c) 2003 ActiveState Corp