Back to Qt.io
Contact Us Blog Download Qt
En esta página

QToolTip Class

La clase QToolTip proporciona consejos sobre herramientas (ayuda en forma de globo) para cualquier widget. Más...

Cabecera: #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 dibuja inmediatamente debajo de la posición dada en una distintiva combinación de colores negro sobre amarillo. El consejo puede ser cualquier cadena con formato rich text.

El texto enriquecido que se muestra en un tool tip está implícitamente envuelto en palabras a menos que se especifique lo contrario con <p style='white-space:pre'>.

Los elementos de interfaz de usuario que se crean a través de QAction utilizan la propiedad tooltip de QAction, por lo que para la mayoría de los elementos de interfaz de usuario interactivos, la forma más sencilla de proporcionar consejos sobre herramientas es establecer dicha propiedad.

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 común de establecer 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 consejos de herramientas para diferentes regiones de un widget, utilizando un QHelpEvent de tipo QEvent::ToolTip. Intercepta el evento help 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 deberías llamar a ignore() en el evento, para señalar que no quieres iniciar ningún modo específico de tooltip.

Tenga en cuenta que, si desea mostrar información sobre herramientas en una vista de elemento, la arquitectura modelo/vista proporciona funcionalidad para establecer la información sobre herramientas de un elemento; por ejemplo, la función QTableWidgetItem::setToolTip(). Sin embargo, si quieres proporcionar consejos personalizados en la vista de un elemento, debes interceptar el evento help en la función QAbstractItemView::viewportEvent() y manejarlo tú mismo.

El color y la fuente predeterminados de la información sobre herramientas pueden personalizarse con setPalette() y setFont(). Cuando se está mostrando un tooltip, isVisible() devuelve true y text() el texto actualmente visible.

Nota: Los tool tips utilizan el grupo de colores inactivos de QPalette, porque los tool tips no son ventanas activas.

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

Documentación de las funciones miembro

[static] QFont QToolTip::font()

Devuelve la fuente utilizada para mostrar la información sobre herramientas.

Véase también setFont().

[static] void QToolTip::hideText()

Oculta la punta de la herramienta. Es lo mismo que llamar a showText() con una cadena vacía.

Véase también showText().

[static] bool QToolTip::isVisible()

Devuelve true si se está mostrando un tooltip.

Véase también showText().

[static] QPalette QToolTip::palette()

Devuelve la paleta utilizada para mostrar los tooltips.

Nota: Los tool tips usan el grupo de colores inactivos de QPalette, porque los tool tips no son ventanas activas.

Véase también setPalette().

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

Establece la dirección font utilizada para mostrar la información sobre herramientas.

Véase también font().

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

Establece el palette utilizado para mostrar los tooltips.

Nota: Los tool tips usan el grupo de colores inactivos de QPalette, porque los tool tips 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 punta de herramienta, con la posición global pos como punto de interés. La punta de la herramienta se mostrará con un desplazamiento específico de la plataforma desde este punto de interés.

Si especifica un rectángulo no vacío, la punta se ocultará tan pronto como mueva el cursor fuera de esta área.

El rect está 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 pero se utiliza para determinar la pantalla apropiada en sistemas multicabezal.

El parámetro msecDisplayTime especifica durante cuánto tiempo se mostrará la punta de la herramienta, en milisegundos. Con el valor por defecto -1, el tiempo se basa en la longitud del texto.

Si text está vacío, la punta de la herramienta se oculta. Si el texto es el mismo que el que se muestra en ese momento, el tooltip no se moverá. Puede forzar el movimiento ocultando primero el consejo con un texto vacío y mostrando después el nuevo consejo en la nueva posición.

[static] QString QToolTip::text()

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

© 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.