桌面应用 / 系统课时

用输入框接收文本内容

用输入框接收文本内容

本节解决桌面应用中如何接收用户文字输入的问题。你将使用 TextField 和 TextArea 构建单行、多行输入区域,并掌握占位提示、只读状态以及读取输入值的方法。

学习目标

  • 理解 TextField 与 TextArea 的适用场景和核心属性。
  • 学会配置占位文本、编辑状态并读取用户输入。
  • 能够在 QML 页面中实现基础文本录入交互。

选择合适的文本输入控件

QML Controls 提供了多个文本输入组件,其中 TextField 适合账号、搜索框、标题等短文本场景,TextArea 适合备注、描述、日志查看等多行内容。

两者都通过 text 属性保存当前内容,通过信号响应用户修改。例如,输入框内容变化时可以使用 onTextChanged 执行业务逻辑。

配置单行和多行输入

下面的示例创建一个简单表单,包含用户名输入框和备注输入区域。

qml
import QtQuick
import QtQuick.Controls

ApplicationWindow {
    width: 400
    height: 300
    visible: true

    Column {
        anchors.centerIn: parent
        spacing: 12

        TextField {
            id: nameInput
            width: 260
            placeholderText: "请输入用户名"
        }

        TextArea {
            id: noteInput
            width: 260
            height: 100
            placeholderText: "请输入备注信息"
        }

        Button {
            text: "读取内容"
            onClicked: console.log(nameInput.text, noteInput.text)
        }
    }
}

预期输出

text
输入用户名 Alice,备注 Hello Qt 后点击按钮
Alice Hello Qt

placeholderText 只在输入为空时显示,不会成为真实文本内容。读取用户输入时,应访问 text 属性,而不是读取占位提示。

控制输入状态

桌面应用中经常需要展示不可编辑的数据,例如用户资料查看页或历史记录。此时可以设置 readOnly 属性。

qml
TextArea {
    width: 300
    height: 120
    text: "这是一段不可编辑内容"
    readOnly: true
}

预期结果

text
页面显示文本内容,用户无法修改输入区域中的文字。

除了只读状态,还可以结合 enabled 控制控件是否参与交互。readOnly 保留可复制能力,而 enabled: false 会同时改变控件交互状态。

使用输入事件处理业务逻辑

实际项目中,输入框通常不会只用于保存数据,而会触发校验、搜索或过滤。例如搜索框可以监听文本变化:

qml
TextField {
    id: searchField
    placeholderText: "搜索"

    onTextChanged: {
        console.log("search:", text)
    }
}

预期输出

text
输入 abc 后
search: abc

设计输入组件时,应根据数据特点选择控件。短文本优先使用 TextField,多段内容使用 TextArea,需要展示内容但禁止修改时使用只读模式。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用输入框接收文本内容

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通