The baltip v1.2.0 is a Tcl/Tk tip widget inspired by:
The original code has been modified to make the tip:
The video introduction to baltip is presented by its demo (15 Mb).
Below are several pictures just to glance at baltip.
Under the mouse pointer. By default, the tips are displayed just under the mouse pointer.
Under the widget. This button's tip is configured to be just under the button. As well as the text's tip.
This feature is well fit for widgets positioned in a row (e.g. in toolbar, tabbar etc.).
Tips of text tags. The text tags can have their own tips.
Tips of menu items. The menu items can have their own tips. The popup menus may be tear-off at that.
The menu tips are useful e.g. when the items are displayed as short names of files, while the tips are wanted to be their full names.
Label of danger. The labels are also tipped. This one is configured to be an alert.
The tags of canvas have tips too.
The tabs of notebook are also supplied with tips.
Configurable tips. The tip configuration can be global or local (for a specific tip).
The configuring can include: font, colors, paddings, border, exposition time, opacity, relief, image (with -compound), bell.
Balloon. The balloon messages aren't related to any widgets. This one is configurated to appear at the top right corner, disappearing after a while.
Usage
The baltip usage is rather straightforward. Firstly we need package require:
lappend auto_path "dir_of_baltip" package require baltip
Then we set tips with ::baltip::tip command for each appropriate widget:
::baltip::tip widgetpath text ?-option value? # or this way: ::baltip tip widgetpath text ?-option value?
For example, having a button .win.but1, we can set its tip this way:
::baltip tip .win.but1 "It's a tip.\n2nd line of it.\n3rd."
To get all or specific settings of baltip:
::baltip::cget ?-option? # or this way: ::baltip cget ?-option?
To set some options:
::baltip::configure -option value ?-option value? # or this way: ::baltip config -option value ?-option value?
Note: the options set with configure command are global, i.e. active for all tips. The options set with tip command are local, i.e. active for the specific tip.
To disable all tips:
::baltip::configure -on false
To disable some specific tip:
::baltip::tip widgetpath "" # or this way: ::baltip::tip widgetpath "old tip" -on false
To hide some specific (suspended) tip by force:
::baltip::hide widgetpath
To update a tip's text and options:
::baltip::update widgetpath text ?options?
When you click on a widget with its tip being displayed, the tip is hidden. It is the default behavior of baltip, but sometimes you need to re-display the hidden tip. If the widget is a button, you can include the following command in -command of the button:
::baltip::repaint widgetpath
Balloon
The normal tip has no -geometry option because it's calculated by baltip, to position the tip under its host widget.
By means of -geometry option you get a balloon message unrelated to any visible widget: it's parented by the toplevel window. The -geometry option has +X+Y form where X and Y are coordinates of the balloon.
For example:
::baltip::tip .win "It's a balloon at +1+100 (+X+Y) coordinates" \ -geometry +1+100 -font {-weight bold -size 12} \ -alpha 0.8 -fg white -bg black -per10 3000 -pause 1500 -fade 1500
The -pause and -fade options make the balloon fade at appearing and disappearing. The -per10 option defines the balloon's duration: the more the longer.
The -geometry value can include W and H wildcards meaning the width and the height of the balloon. This may be useful when you need to show a balloon at a window's edge and should use the balloon's dimensions which are available only after its creation. The X and Y coordinates are calculated by baltip as normal expressions. Of course, they should not include the "+" divider, but this restriction (if any) is easily overcome.
For example:
lassign [split [winfo geometry .win] x+] w h x y set geom "+([expr {$w+$x}]-W-4)+$y" set text "The balloon at the right edge of the window" ::baltip tip .win $text -geometry $geom -pause 2000 -fade 2000
Options
Below are listed the baltip options that are set with tip and configure and got with cget:
The following options are special:
If -global yes option is used alone, it applies all global options to all registered tips. If -global yes option is used along with other options, only those options are applied to all registered tips.
Of course, all global options will be applied to all tips to be created after ::baltip configuration. For example:
::baltip config -global yes ;# applies all global options to all registered and to-be-created tips ::baltip config -global yes -per10 2000 ;# applies `-per10` to all registered and to-be-created tips
The -index option may have numeric (0, 1, 2...) or symbolic form (active, end, none) to indicate a menu entry, e.g. in -command option. For example:
::baltip repaint .win.popupMenu -index active ::baltip::tip .menu "File actions" -index 0
As seen in the above examples, baltip can be used as Tcl ensemble, so that the commands may be shortened.
See more examples of use in test.tcl of baltip.zip .
Also, you can test baltip with test2_pave.tcl of apave package .
Links