Rechercher une page de manuel
tooltip.3tk
Langue: en
Version: 1.4 (ubuntu - 07/07/09)
Section: 3 (Bibliothèques de fonctions)
NAME
tooltip - Tooltip managementSYNOPSIS
package require Tcl 8.4package require msgcat 1.3
package require tooltip ?1.4?
::tooltip::tooltip command ?options?
::tooltip::tooltip pathName ?option arg? message
DESCRIPTION
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.
COMMANDS
- ::tooltip::tooltip command ?options?
- Manage the tooltip package using the following subcommands.
-
- clear index
- Prevents the specified widgets from showing tooltips. pattern is a glob pattern and defaults to matching all widgets.
- delay ?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.
- fade ?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.
- disable
- off
- Disable all tooltips
- enable
- on
- Enables tooltips for defined widgets.
-
- ::tooltip::tooltip pathName ?option arg? message
- This command arranges for widget pathName to display a tooltip with message 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.
-
- -index 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.
- -item 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.
- -tag name
- The -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.
-
EXAMPLE
# Demonstrate widget tooltip package require tooltip pack [label .l -text "label"] tooltip::tooltip .l "This is a label widget"
# 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"
# 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"
# 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
balloon, help, hover, tooltipCOPYRIGHT
Copyright (c) 1996-2007, Jeffrey Hobbs
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre