En esta página

Teclado virtual en Qt Quick

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

Ventana de la aplicación con campos de texto etiquetados situados encima del teclado virtual para introducir texto

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:

Proyecto de ejemplo en code.qt.io

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