Teclado virtual en Qt Quick
Este ejemplo muestra cómo utilizar el teclado virtual en una aplicación de Qt Quick.

El ejemplo cuenta con dos implementaciones: una para plataformas de escritorio y otra para plataformas integradas. La primera versión permite introducir texto en varios campos de texto mediante el teclado virtual, mientras que la segunda versión utiliza la misma interfaz de usuario, pero con un teclado virtual personalizado de InputPanel. Los siguientes fragmentos de código muestran cómo configurar el proyecto para elegir la implementación adecuada en función de las opciones de CONFIG:
- En qmake (
basic.pro):!qtConfig(vkb-desktop) { DEFINES += MAIN_QML=\\\"basic-b2qt.qml\\\" } else { DEFINES += MAIN_QML=\\\"Basic.qml\\\" } - En CMake (
CMakeLists.txt):if(NOT QT_FEATURE_vkb_desktop) target_compile_definitions(basic PUBLIC MAIN_QML="basic-b2qt.qml" ) endif() ... if(QT_FEATURE_vkb_desktop) target_compile_definitions(basic PUBLIC MAIN_QML="Basic.qml" ) endif()
El ejemplo habilita el teclado virtual configurando la variable de entorno QT_IM_MODULE antes de cargar el archivo .qml:
#include <QQuickView>
#include <QGuiApplication>
#include <QQmlEngine>
int main(int argc, char *argv[])
{
qputenv("QT_IM_MODULE", QByteArray("qtvirtualkeyboard"));
QGuiApplication app(argc, argv);
QQuickView view(QString("qrc:/%2").arg(MAIN_QML));
if (view.status() == QQuickView::Error)
return -1;
view.setResizeMode(QQuickView::SizeRootObjectToView);
view.show();
return app.exec();
}Además, utiliza elementos personalizados TextField y TextArea para configurar el comportamiento de la tecla [ENTER] mediante la propiedad asociada EnterKeyAction.
import QtQuick
import QtQuick.Controls
import QtQuick.VirtualKeyboard
import "content"
Rectangle {
...
TextField {
width: parent.width
placeholderText: "One line field"
enterKeyAction: EnterKeyAction.Next
onAccepted: passwordField.focus = true
}
...
TextArea {
id: textArea
width: parent.width
placeholderText: "Multiple line field"
height: Math.max(206, implicitHeight)
}
}Los controles TextField y TextArea amplían los respectivos tipos de controlesQt Quick Controls 2 con las propiedades enterKeyEnabled y enterKeyAction. Las instancias TextField y TextArea del fragmento de código pueden establecer estas propiedades para cambiar el comportamiento predeterminado.
Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
© 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.