c15c41b3d49cb056ec5f310826b2618d.png
这是一个使用Qt虚拟键盘的QML文本输入示例。

4d5ab5753d4ea6c5fafb278cd7f7e1d7.gif

该示例提供两种使用方式：一种用于桌面平台，另一种用于嵌入式平台，本例采用嵌入式平台方式显示。它们区别是前者脱离窗口应用于全局，后者依附于窗口。

disable-desktop|android-embedded|!isEmpty(CROSS_COMPILE)|qnx {
    DEFINES += MAIN_QML="basic-b2qt.qml" # 采用了自定义的虚拟键盘的InputPanel，可以依附窗口。
} else {
    DEFINES += MAIN_QML="Basic.qml"      # 独立于窗口
}

0x00 使用(Qt5.7版本以上)

  1. 代码添加
qputenv("QT_IM_MODULE", QByteArray("qtvirtualkeyboard"));
  1. Qml文件导入模块
import QtQuick.VirtualKeyboard 2.1
  1. TextInput派生类类带有TextInput派生类的控件获得输入焦点即可调用出虚拟键盘。

0x01 根据不同的输入方式显示不同的键盘

  • 设置inputMethodHints变量即可
TextField {
    id: digitsField
    width: parent.width
    placeholderText: "Digits only field" /* 输入为空时显示的提示文字 */
    inputMethodHints: Qt.ImhDigitsOnly   /* 输入策略 */
    enterKeyAction: EnterKeyAction.Next  /* 键盘确定键策略 */
    onAccepted: textArea.focus = true    /* 结束输入操作行为 */
}
  • 常用值有：

915c5f809ad96057674bb98846c04d49.png

0x02 预览

  • 默认键盘

a444dd142653eb39637295557d5acb17.png
  • 数字键盘

7c6783083f363c2400e62a853576598d.png
  • 数字键盘 + 逻辑符号键盘

e2a8fe04fd592d199a56daceca8efabf.png
  • 支持切换输入法

dfcf7100b336ce413b0adb19957f6b16.png

0x03 关于更多

  • 在QtCreator软件可以找到：

db04f441d35bca4abb9dad2a160e2d81.png
  • 或在以下Qt安装目录找到：
C:Qt{你的Qt版本}Examples{你的Qt版本}virtualkeyboardbasic
  • 相关链接
https://doc.qt.io/qt-5/qtvirtualkeyboard-basic-example.html
  • Qt君公众号回复『Qt示例』获取更多内容。
Logo
华为开发者空间

华为开发者空间，是为全球开发者打造的专属开发空间，汇聚了华为优质开发资源及工具，致力于让每一位开发者拥有一台云主机，基于华为根生态开发、创新。

更多推荐

如何在鲲鹏平台上快速上手应用开发？鲲鹏DevKit给你答案

鲲鹏DevKit针对不同的业务场景，提供了应用迁移和系统迁移两套解决方案，帮忙开发者快速从X86平台迁移至鲲鹏平台，通过详细的迁移建议降低迁移门槛，可视化展示迁移进度，打消鲲鹏平台开发的顾虑。

avatar 华为开发者空间
cover

AI大模型高效开发神器来了 ，解读ModelArts 8大能力

avatar 华为开发者空间
cover

华为云开源项目Sermant正式成为CNCF官方项目

avatar 华为开发者空间