QWhatsThis Class
La clase QWhatsThis ofrece una descripción sencilla de cualquier widget, es decir, responde a la pregunta «¿Qué es esto?». Más información...
| Encabezado: | #include <QWhatsThis> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
- Lista de todos los miembros, incluidos los heredados
- QWhatsThis forma parte del sistema de ayuda.
Miembros públicos estáticos
| QAction * | createAction(QObject *parent = nullptr) |
| void | enterWhatsThisMode() |
| void | hideText() |
| bool | inWhatsThisMode() |
| void | leaveWhatsThisMode() |
| void | showText(const QPoint &pos, const QString &text, QWidget *w = nullptr) |
Descripción detallada
La ayuda «¿Qué es esto?» forma parte del sistema de ayuda en línea de una aplicación y proporciona a los usuarios información sobre la funcionalidad y el uso de un control concreto. Los textos de ayuda de «¿Qué es esto?» suelen ser más largos y detallados que los de « tooltips », pero, por lo general, ofrecen menos información que la que proporcionan las ventanas de ayuda independientes.
QWhatsThis ofrece una única ventana con un texto explicativo que aparece cuando el usuario pregunta «¿Qué es esto?». La forma predeterminada en que los usuarios pueden plantear la pregunta es situar el foco en el widget correspondiente y pulsar Mayús+F1. El texto de ayuda aparece inmediatamente; desaparece en cuanto el usuario realiza otra acción. (Ten en cuenta que, si existe un atajo para Mayús+F1, este mecanismo no funcionará). Algunos cuadros de diálogo incluyen un botón «?» en el que los usuarios pueden hacer clic para entrar en el modo «¿Qué es esto?»; a continuación, hacen clic en el widget correspondiente para que aparezca la ventana «¿Qué es esto?». También es posible incluir una opción de menú o un botón en la barra de herramientas para pasar al modo «¿Qué es esto?».
Para añadir el texto «¿Qué es esto?» a un control o a una acción, basta con llamar a QWidget::setWhatsThis() o QAction::setWhatsThis().
El texto puede ser de formato enriquecido o texto sin formato. Si se especifica una cadena con formato de texto enriquecido, se representará utilizando la hoja de estilos predeterminada, lo que permite incrustar imágenes en el texto mostrado. Para que el proceso sea lo más rápido posible, la hoja de estilos predeterminada utiliza un método sencillo para determinar si el texto puede representarse como texto sin formato. Consulta Qt::mightBeRichText() para obtener más detalles.
newAct = new QAction(tr("&New"), this);
newAct->setShortcut(tr("Ctrl+N"));
newAct->setStatusTip(tr("Create a new file"));
newAct->setWhatsThis(tr("Click this option to create a new file."));Una forma alternativa de acceder al modo «¿Qué es esto?» es llamar a createAction(), y añadir el objeto QAction devuelto a un menú o a una barra de herramientas. Al invocar esta acción de ayuda contextual (en la imagen siguiente, el botón con el icono de la flecha y el signo de interrogación), el usuario pasa al modo «¿Qué es esto?». Si ahora hace clic en un widget, se muestra el texto de ayuda correspondiente. Se sale del modo cuando se proporciona la ayuda o cuando el usuario pulsa Esc.

Puedes entrar en el modo «¿Qué es esto?» mediante programación con enterWhatsThisMode(), comprobar el modo con inWhatsThisMode() y volver al modo normal con leaveWhatsThisMode().
Si deseas controlar manualmente el comportamiento de «¿Qué es esto?» de un widget, consulta Qt::WA_CustomWhatsThis.
También es posible mostrar diferentes textos de ayuda para distintas regiones de un widget, utilizando un QHelpEvent de tipo QEvent::WhatsThis. Intercepta el evento de ayuda en la función QWidget::event() de tu widget y llama a QWhatsThis::showText() con el texto que quieras mostrar para la posición especificada en QHelpEvent::pos(). Si el texto es de formato enriquecido y el usuario hace clic en un enlace, el widget también recibe un ` QWhatsThisClickedEvent ` con la referencia del enlace como ` QWhatsThisClickedEvent::href()`. Si se gestiona un ` QWhatsThisClickedEvent ` (es decir, si ` QWidget::event()` devuelve `true`), la ventana de ayuda permanece visible. Llama a ` QWhatsThis::hideText()` para ocultarla explícitamente.
Véase también QToolTip.
Documentación de funciones de miembro
[static] QAction *QWhatsThis::createAction(QObject *parent = nullptr)
Devuelve un objeto ` QAction` ya preparado, que se utiliza para invocar la ayuda contextual «¿Qué es esto?», con el ` parent` indicado.
El objeto ` QAction ` devuelto ofrece una forma cómoda de permitir a los usuarios acceder al modo «¿Qué es esto?».
[static] void QWhatsThis::enterWhatsThisMode()
Esta función cambia la interfaz de usuario al modo «¿Qué es esto?». El usuario puede volver a cambiar la interfaz de usuario al modo normal (por ejemplo, haciendo clic o pulsando la tecla Esc), o mediante programación llamando a ` leaveWhatsThisMode()` ().
Al entrar en el modo «¿Qué es esto?», se envía un QEvent de tipo Qt::EnterWhatsThisMode a todos los widgets de nivel superior.
Véanse también inWhatsThisMode() y leaveWhatsThisMode().
[static] void QWhatsThis::hideText()
Si aparece una ventana de «¿Qué es esto?», esta acción la cierra.
Véase también showText().
[static] bool QWhatsThis::inWhatsThisMode()
Devuelve « true » si la interfaz de usuario se encuentra en el modo «¿Qué es esto?»; en caso contrario, devuelve « false ».
Véase también enterWhatsThisMode().
[static] void QWhatsThis::leaveWhatsThisMode()
Si la interfaz de usuario se encuentra en el modo «¿Qué es esto?», esta función vuelve al modo normal; en caso contrario, no realiza ninguna acción.
Al salir del modo «¿Qué es esto?», se envía un mensaje ` QEvent ` de tipo `Qt::LeaveWhatsThisMode` a todos los widgets de nivel superior.
Véase también ` enterWhatsThisMode()` y ` inWhatsThisMode()`.
[static] void QWhatsThis::showText(const QPoint &pos, const QString &text, QWidget *w = nullptr)
Muestra « text » en una ventana de «¿Qué es esto?», en la posición global pos. El argumento opcional «widget», w, se utiliza para determinar la pantalla adecuada en sistemas con varios monitores.
Véase también hideText().
© 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.