1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
[comment {-*- tcl -*- doctools manpage}]
[manpage_begin tooltip n 1.4]
[copyright {1996-2007, Jeffrey Hobbs}]
[moddesc {Tooltip management}]
[titledesc {Tooltip management}]
[require Tcl 8.4]
[require msgcat 1.3]
[require tooltip [opt 1.4]]
[description]
[para]
This package provides tooltips, small text messages that can be displayed
when the mouse hovers over a widget, menu item, canvas item or text
widget tag.
[section {COMMANDS}]
[list_begin definitions]
[call [cmd ::tooltip::tooltip] [arg command] [opt [arg options]]]
Manage the tooltip package using the following subcommands.
[list_begin options]
[opt_def clear [arg index]]
Prevents the specified widgets from showing tooltips. [arg pattern]
is a glob pattern and defaults to matching all widgets.
[opt_def delay [opt [arg millisecs]]]
Query or set the hover delay. This is the interval that the pointer must remain
over the widget before the tooltip is displayed. The delay is specified in
milliseconds and must be greater than 50ms.
With no argument the current delay is returned.
[opt_def fade [opt [arg boolean]]]
Enable or disable fading of the tooltip. The is enabled by default on Win32
and Aqua. The tooltip will fade away on Leave events instead disappearing.
[opt_def disable]
[opt_def off]
Disable all tooltips
[opt_def enable]
[opt_def on]
Enables tooltips for defined widgets.
[list_end]
[nl]
[call [cmd ::tooltip::tooltip] \
[arg pathName] [opt [arg "option arg"]] [arg message]]
This command arranges for widget [arg pathName] to display a tooltip with
message [arg message]. The tooltip uses a late-binding msgcat call on the
passed in message to allow for on-the-fly language changes in an application.
If the widget specified is a menu, canvas or text widget then additional options
are used to tie the tooltip to specific menu entries, canvas items or text
tags.
[list_begin options]
[opt_def -index [arg index]]
This option is used to set a tooltip on a menu item. The index may be
either the entry index or the entry label. The widget must be a menu
widget but the entries do not have to exists when the tooltip is set.
[opt_def -item [arg name]]
This option is used to set a tooltip for a canvas widget item. The
item must already be present in the canvas widget and the widget must
be a canvas widget or an error is raised.
[opt_def -tag [arg name]]
The [option -tag] option can be used to set a tooltip for a text widget
tag. The tag should already be present when this command is called or
an error will be returned. The widget must also be a text widget.
[list_end]
[list_end]
[section EXAMPLE]
[example {
# Demonstrate widget tooltip
package require tooltip
pack [label .l -text "label"]
tooltip::tooltip .l "This is a label widget"
}]
[example {
# Demonstrate menu tooltip
package require tooltip
. configure -menu [menu .menu]
.menu add cascade -label Test -menu [menu .menu.test -tearoff 0]
.menu.test add command -label Tooltip
tooltip::tooltip .menu.test -index 0 "This is a menu tooltip"
}]
[example {
# Demonstrate canvas item tooltip
package require tooltip
pack [canvas .c]
set item [.c create rectangle 10 10 80 80]
tooltip::tooltip .c -item $item "Canvas item tooltip"
}]
[example {
# Demonstrate text tag tooltip
package require tooltip
pack [text .txt]
.txt tag configure TIP-1 -underline 1
tooltip::tooltip .txt -tag TIP-1 "tooltip one text"
.txt insert end "An example of a " {} "tooltip" TIP-1 " tag.\n" {}
}]
[keywords tooltip hover balloon help]
[manpage_end]
|
