En esta página

QToolTip Class

La clase QToolTip proporciona información sobre herramientas (globos de ayuda) para cualquier widget. Más...

Encabezado: #include <QToolTip>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets

Miembros públicos estáticos

QFont font()
void hideText()
bool isVisible()
QPalette palette()
void setFont(const QFont &font)
void setPalette(const QPalette &palette)
void showText(const QPoint &pos, const QString &text, QWidget *w = nullptr, const QRect &rect = {}, int msecDisplayTime = -1)
QString text()

Descripción detallada

La sugerencia es un breve texto que recuerda al usuario la función del widget. Se muestra inmediatamente debajo de la posición indicada, con una combinación de colores distintiva de negro sobre amarillo. La sugerencia puede ser cualquier cadena formateada mediante rich text.

El texto enriquecido que se muestra en una sugerencia se ajusta implícitamente a la línea, a menos que se especifique lo contrario con ` <p style='white-space:pre'>`.

Los elementos de la interfaz de usuario creados mediante ` QAction ` utilizan la propiedad `tooltip` de ` QAction`, por lo que, para la mayoría de los elementos interactivos de la interfaz de usuario, configurar dicha propiedad es la forma más sencilla de proporcionar información sobre herramientas.

QAction *openAction = new QAction(tr("&Open..."));
openAction->setToolTip(tr("Open an existing file"));

fileMenu = menuBar()->addMenu(tr("&File"));
fileToolBar = addToolBar(tr("&File"));

fileMenu->addAction(openAction);
fileToolBar->addAction(openAction);

Para cualquier otro widget, la forma más sencilla y habitual de configurar la información sobre herramientas de un widget es llamando a su función ` QWidget::setToolTip()`.

searchBar = new SearchBar;
searchBar->setToolTip(tr("Search in the current document"));

También es posible mostrar diferentes informaciónes de ayuda para distintas regiones de un widget, utilizando un ` QHelpEvent ` de tipo ` QEvent::ToolTip`. Intercepta el evento de ayuda en la función ` event()` de tu widget y llama a ` QToolTip::showText()` con el texto que quieras mostrar.

bool Window::event(QEvent *event)
{
    if (event->type() == QEvent::ToolTip) {
        auto *helpEvent = static_cast<QHelpEvent *>(event);
        if (Element *element = elementAt(helpEvent->pos())) {
            QToolTip::showText(helpEvent->globalPos(), element->toolTip(), this);
        } else {
            QToolTip::hideText();
            event->ignore();
        }

        return true;
    }
    return QWidget::event(event);
}

Si llamas a ` QToolTip::hideText()` o a ` QToolTip::showText()` con una cadena vacía, como resultado de un evento ` ToolTip`, también debes llamar a ` ignore()` en el evento, para indicar que no deseas iniciar ningún modo específico de información sobre herramientas.

Ten en cuenta que, si deseas mostrar información sobre herramientas en la vista de un elemento, la arquitectura modelo/vista proporciona funcionalidades para configurar la información sobre herramientas de un elemento; por ejemplo, la función QTableWidgetItem::setToolTip(). Sin embargo, si deseas proporcionar información sobre herramientas personalizada en la vista de un elemento, debes interceptar el evento de ayuda en la función QAbstractItemView::viewportEvent() y gestionarlo tú mismo.

El color y la fuente predeterminados de las descripciones emergentes se pueden personalizar con setPalette() y setFont(). Cuando hay una descripción emergente visible, isVisible() devuelve true y text() devuelve el texto visible en ese momento.

Nota: Las descripcionesemergentes utilizan el grupo de colores inactivo de QPalette, ya que no son ventanas activas.

Véase también QWidget::toolTip y QAction::toolTip.

Documentación de funciones de miembro

[static] QFont QToolTip::font()

Devuelve la fuente utilizada para mostrar las descripciones emergentes.

Véase también setFont().

[static] void QToolTip::hideText()

Oculta la información sobre herramientas. Es lo mismo que llamar a ` showText()` con una cadena vacía.

Véase también showText().

[static] bool QToolTip::isVisible()

Devuelve « true » si actualmente se muestra una descripción emergente.

Véase también showText().

[static] QPalette QToolTip::palette()

Devuelve la paleta utilizada para mostrar las descripciones emergentes.

Nota: Las descripcionesemergentes utilizan el grupo de colores inactivo de QPalette, ya que no son ventanas activas.

Véase también setPalette().

[static] void QToolTip::setFont(const QFont &font)

Establece el objeto ` font ` que se utiliza para mostrar las descripciones emergentes.

Véase también font().

[static] void QToolTip::setPalette(const QPalette &palette)

Establece el grupo de colores « palette » que se utiliza para mostrar las descripciones emergentes.

Nota: Las descripcionesemergentes utilizan el grupo de colores inactivo de ` QPalette`, ya que no son ventanas activas.

Véase también palette().

[static] void QToolTip::showText(const QPoint &pos, const QString &text, QWidget *w = nullptr, const QRect &rect = {}, int msecDisplayTime = -1)

Muestra « text » como información sobre herramientas, con la posición global pos como punto de interés. La información sobre herramientas se mostrará con un desplazamiento específico de la plataforma respecto a este punto de interés.

Si se especifica un rectángulo no vacío, la información sobre herramientas se ocultará en cuanto se mueva el cursor fuera de esta zona.

El ` rect ` se encuentra en las coordenadas del widget que especifiques con ` w`. Si el ` rect ` no está vacío, debes especificar un widget. De lo contrario, este argumento puede ser ` nullptr `, aunque se utiliza para determinar la pantalla adecuada en sistemas con múltiples monitores.

El parámetro msecDisplayTime especifica durante cuánto tiempo se mostrará la información sobre herramientas, en milisegundos. Con el valor predeterminado de -1, el tiempo se basa en la longitud del texto.

Si text está vacío, la información sobre herramientas queda oculta. Si el texto es el mismo que el de la información sobre herramientas que se muestra actualmente, esta no se desplazará. Puedes forzar el desplazamiento ocultando primero la información sobre herramientas con un texto vacío y, a continuación, mostrando la nueva información en la nueva posición.

[static] QString QToolTip::text()

Devuelve el texto de la información sobre herramientas, si esta está visible, o una cadena vacía si no lo está.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.