Cómo usar Tool Tips

Crear un tool tip para cualquier JComponent es fácil. Sólo dmeos usar el método setToolTipText para configurar un tool tip para el componente. Por ejemplo, para añadir tool tips a tres botones, sólo tenemos que añadir tres líneas de código:
b1.setToolTipText("Click this button to disable the middle button.");
b2.setToolTipText("This middle button does nothing when you click it.");
b3.setToolTipText("Click this button to enable the middle button.");
Cuando el usuario del programa para el cursor sobre cualquiera de los botones, aparece el tool tip dle botón. Puedes ver esto ejecutando el ejemplo ButtonDemo, que se explicó en Cómo usar Buttons. Aquí tenemos una imagen del tool tip que aparece cuando el cursor se para sobre el botón de la izquierda en ButtonDemo:
[Por favor, imagínate un cursor sobre el botón. Gracias.]

El API de Tool Tip

La mayoría del API que necesitas para usar tool tips está en JComponent, y así lo heredan todos los componentes Swing (excepto los contenedores de alto nivel). Este API se cubre en una tabla más adelante en esta sección.

Más API de tool-tip se encuentra en clases individuales como JTabbedPane. Cada página de componente tiene información sobre su API de tool-tip, si existe.

Si quieres evitar o personalizar el manejo por defecto de tooltips, probablemente tendrás que tratar directamente con JToolTip o ToolTipManager

El API de Tool Tip en JComponent
Método Propósito
setToolTipText(String)
(en JComponent)
Si el string especificado no es nulo, esté métod registra el componente para tener un tooltip y hace que el tool-tip cuando se muestre tenga el texto especificado. Si el argumento es null, desactiva el tool-tip para este componente.
String getToolTipText()
(en JComponent)
Devuelve el string que fue especificado anteriormente con setToolTipText.
String getToolTipText(MouseEvent)
(en JComponent)
Por defecto devuelve el mismo valor devuelto por getToolTipText(). Componentes multi-parte como JTabbedPane, JTable, y JTree sobreescriben este método para devolver un string asocuado con la posición de ratón. Por ejemplo, cada pestaña en un tabbed pane puede tener un tool-tip diferente.
setToolTipLocation(Point)
Point getToolTipLocation()

(en JComponent)
Selecciona u obtiene la posición (en el sistema de coordenadas del componente recibido) donde aparecerá la esquina superior izquierda del tool-tip. El valor por defecto es nulo, lo que le dice a Swing que elija una posición.

Ejemplos que usan Tool Tips

Esta tabla muestra ejemplos que san tool-tips y dónde encontrarlos.

Ejemplo Dónde se describe Notas
ButtonDemo.java Esta página y Cómo usar Buttons usa un tool-tip para proporcionar las instrucciones de un botón.
IconDemoApplet.java Cómo usar Icons Usa un tool-tip para proporcionar el nombre y el tamaño de una imagen.
TabbedPaneDemo.java Cómo usar Tabbed Panes Especifica un tool-tip para cada pestaña.
TableRenderDemo.java Cómo usar Tables Añade tool-tips usando renderizadores y editores personalizados.
ActionDemo.java Cómo usar Actions Añade tool-tips a los botones creados usando Actions.


Ozito