DOKK / manpages / debian 13 / tklib / tipstack.3tk.en
tipstack(3tk) Tooltip management tipstack(3tk) 







tipstack - Stacked tooltips








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












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.









  
::tipstack::push widget ?-index index?
    text

  
Push a new text to the tooltip for the widget. In case of a
      list widget use






-index ...





  

  
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 ...





  

  
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 ...





  

  
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

  










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.








balloon, help, hover, tipstack








Copyright (c) 2003 ActiveState Corp








  

    1.0.1
    tklib