Qt5.12.6：macOS下Password模式TextField允许非ASCII输入问题咨询

1. 平台差异说明 #

这是Qt的平台专属特性：

• Windows平台下，设置echoMode: TextInput.Password的TextField会默认禁用非ASCII的IME输入，属于Qt对Windows系统密码输入框的行为适配
• macOS平台无此限制，允许IME输入非ASCII字符，且焦点切换时自动切换IME语言，是Qt对macOS系统控件行为的兼容逻辑，并非你遗漏了设置

2. macOS平台禁止非ASCII IME输入的解决方案 #

方案1：QML层面直接实现（无需C++） #

通过inputMethodHints限制IME行为，结合textChanged信号过滤非ASCII字符，仅针对macOS做适配（避免影响Windows默认逻辑）：

Window {
  visible: true
  width: 640
  height: 480
  title: "window"

  Column {
    width:  parent.width
    height: parent.height
    spacing: 10

    TextField {
      id: test
      echoMode: TextInput.Password
      width: 200
      
      // macOS下设置IME提示，禁用自动切换、预测输入
      inputMethodHints: Qt.platform.os === "osx" ? 
        Qt.ImhNoAutoUppercase | Qt.ImhNoPredictiveText | Qt.ImhHiddenText : 
        Qt.ImhHiddenText

      // 过滤非ASCII字符，仅保留ASCII码范围内的内容
      onTextChanged: {
        if (Qt.platform.os === "osx") {
          let filteredText = "";
          for (let char of text) {
            if (char.charCodeAt(0) <= 127) { // ASCII字符范围：0-127
              filteredText += char;
            }
          }
          if (filteredText !== text) {
            text = filteredText;
          }
        }
      }
    }
    Text {
      id: test2
      width: 200
      text: test.text
    }
  }
}

方案2：C++扩展实现（更彻底的IME拦截） #

若QML层面过滤不够彻底，可通过自定义QQuickTextField子类拦截IME输入事件：

1. 创建自定义控件类：

#include <QQuickTextField>
#include <QInputMethodEvent>

class RestrictedPasswordField : public QQuickTextField
{
    Q_OBJECT
public:
    explicit RestrictedPasswordField(QQuickItem *parent = nullptr) : QQuickTextField(parent) {}

protected:
    void inputMethodEvent(QInputMethodEvent *event) override {
        // 仅处理ASCII字符的输入事件
        QString filteredText;
        for (const QChar &c : event->commitString()) {
            if (c.unicode() <= 127) {
                filteredText.append(c);
            }
        }
        if (!filteredText.isEmpty()) {
            event->setCommitString(filteredText);
            QQuickTextField::inputMethodEvent(event);
        } else {
            event->ignore();
        }
    }
};

2. 在main.cpp中注册到QML：

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include "RestrictedPasswordField.h"

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    qmlRegisterType<RestrictedPasswordField>("CustomControls", 1, 0, "RestrictedPasswordField");

    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    if (engine.rootObjects().isEmpty())
        return -1;

    return app.exec();
}

3. QML中使用自定义控件：

import CustomControls 1.0

Window {
  visible: true
  width: 640
  height: 480
  title: "window"

  Column {
    width:  parent.width
    height: parent.height
    spacing: 10

    RestrictedPasswordField {
      id: test
      echoMode: TextInput.Password
      width: 200
    }
    Text {
      id: test2
      width: 200
      text: test.text
    }
  }
}

3. 效果验证 #

两种方案均可实现macOS下密码框禁止非ASCII（韩语）IME输入，同时保留Windows平台的默认行为，与DBeaver密码框效果一致。

内容的提问来源于stack exchange，提问作者jeffkim