桌面应用 / 系统课时
用输入框接收文本内容
用输入框接收文本内容
本节解决桌面应用中如何接收用户文字输入的问题。你将使用 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 QtplaceholderText 只在输入为空时显示,不会成为真实文本内容。读取用户输入时,应访问 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,需要展示内容但禁止修改时使用只读模式。
按自己的节奏,确认真正理解。