QML中的自定义键盘处理：禁用iOS/Android上的默认屏幕上移行为

嘿，刚好我折腾过QML在移动端的键盘适配问题，要完全禁用iOS和Android上默认的屏幕上移行为，得针对两个平台分别处理，毕竟它们的系统机制不一样，下面给你唠唠具体怎么做：

• Android平台：
  你需要修改项目里的AndroidManifest.xml文件，找到对应Activity的标签，添加android:windowSoftInputMode="adjustNothing"属性。这个属性会告诉Android系统，不要自动调整屏幕布局来适配弹出的键盘。
  修改后的Activity标签大概长这样：

  <activity
      android:name="org.qtproject.qt.android.bindings.QtActivity"
      android:windowSoftInputMode="adjustNothing"
      ...其他原有属性...>
  </activity>
  

  要是你用Qt Creator自动生成的项目模板，直接在对应的位置插入这个属性就行，编译后Android系统就不会默认上移屏幕了。

• iOS平台：
  这里分Qt版本两种情况：

  • 如果你用的是Qt 6.2及以上版本，那可太方便了，直接在根Window或者ApplicationWindow里加一行代码就行：

    ApplicationWindow {
        id: rootWindow
        visible: true
        width: 480
        height: 640
    
        keyboardTrackingEnabled: false // 直接禁用iOS默认的键盘上移行为
    
        // 你的其他界面元素代码
    }
    

  • 要是还在维护Qt 5.x的老项目，就得加一点C++代码辅助了。在main.cpp里获取iOS的UIViewController实例，关闭它的自动调整布局属性：

    #include <QGuiApplication>
    #include <QQmlApplicationEngine>
    #ifdef Q_OS_IOS
    #include <QtGui/qpa/qplatformnativeinterface.h>
    #include <UIKit/UIKit.h>
    #endif
    
    int main(int argc, char *argv[]) {
        QGuiApplication app(argc, argv);
    
    #ifdef Q_OS_IOS
        QPlatformNativeInterface *nativeInterface = QGuiApplication::platformNativeInterface();
        UIViewController *rootViewController = static_cast<UIViewController*>(nativeInterface->nativeResourceForWindow("uiviewcontroller", nullptr));
        if (rootViewController) {
            rootViewController->automaticallyAdjustsScrollViewInsets = NO;
        }
    #endif
    
        QQmlApplicationEngine engine;
        const QUrl url(u"qrc:/main.qml"_qs);
        QObject::connect(&engine, &QQmlApplicationEngine::objectCreated,
                         &app, [url](QObject *obj, const QUrl &objUrl) {
            if (!obj && url == objUrl)
                QCoreApplication::exit(-1);
        }, Qt::QueuedConnection);
        engine.load(url);
    
        return app.exec();
    }
    

搞定了系统默认行为的禁用，接下来你就可以自己实现类似React Native KeyboardAvoidingView的自定义逻辑了。比如监听Qt.inputMethod的keyboardRectangleChanged信号，根据键盘的高度动态调整界面元素的位置或大小：

ApplicationWindow {
    id: root
    visible: true
    width: 480
    height: 640
    keyboardTrackingEnabled: false

    Column {
        id: mainContent
        anchors.fill: parent
        anchors.bottomMargin: Qt.inputMethod.keyboardRectangle.height > 0 ? Qt.inputMethod.keyboardRectangle.height : 0

        TextInput {
            id: inputField
            width: parent.width
            height: 40
            placeholderText: "输入点什么..."
            anchors.bottom: parent.bottom
        }
    }

    Connections {
        target: Qt.inputMethod
        onKeyboardRectangleChanged: {
            // 这里可以根据需求，精细控制布局调整逻辑
            mainContent.anchors.bottomMargin = Qt.inputMethod.keyboardRectangle.height
        }
    }
}

这样你就能完全掌控键盘弹出时的界面变化，想怎么调就怎么调～

备注：内容来源于stack exchange，提问作者posix