【Qt】输入类控件QLineEdit

最新推荐文章于 2025-09-27 19:11:32 发布

原创

最新推荐文章于 2025-09-27 19:11:32 发布 · 1.8k 阅读

CC 4.0 BY-SA版权

文章标签：

输入类控件QLineEdit

核心属性

属性	说明
text	输⼊框中的⽂本
inputMask	输⼊内容格式约束
maxLength	最⼤⻓度
frame	是否添加边框
echoMode	显⽰⽅式. QLineEdit::Normal ：这是默认值，⽂本框会显⽰输⼊的⽂本。 QLineEdit::Password ：在这种模式下，输⼊的字符会被隐藏，通常⽤星号（*）或等号（=）代替。 QLineEdit::NoEcho ：在这种模式下，⽂本框不会显⽰任何输⼊的字符。
cursorPosition	光标所在位置
alignment	⽂字对⻬⽅式, 设置⽔平和垂直⽅向的对⻬.
dragEnabled	是否允许拖拽
readOnly	是否是只读的(不允许修改)
placeHolderText	当输⼊框内容为空的时候, 显⽰什么样的提⽰信息
clearButtonEnabled	是否会⾃动显⽰出 "清除按钮".

text属性，不仅仅可以通过代码来设置，用户在输入框中进行编辑，也会影响到text值的变化

（1）通过代码中设置text，界面上的文本会发生变化

（2）直接操作修改界面上的文本（输入框、可以编辑的），text属性的值也会发生改变。

placeHolderText可以起到“提示作用”

当输入框为空的时候，没有任何内容的时候，提示信息才会存在。

一旦用户在这里进行任何动作输入，这个提示信息就会消失。

clearButtonEnabled可以显示清空按钮！

如果输入框为空，此时没有任何显示。

当输入框有内容的时候，右侧就会出现一个类似于删除的按钮，点击按钮就会立即将输入框里面的内容清空。

核心信号

属性	说明
void cursorPositionChanged(int old, int new)	当⿏标移动时发出此信号，old为先前的位置，new为新位置。
void editingFinished()	当按返回或者回⻋键时，或者⾏编辑失去焦点时，发出此信号
void returnPressed()	当返回或回⻋键按下时发出此信号. 如果设置了验证器, 必须要验证通过, 才能触发.
void selectionChanged()	当选中的⽂本改变时，发出此信号。
void textChanged(const QString &text)	当QLineEdit中的⽂本改变时，发出此信号，text是新的⽂本。代码对⽂本的修改能够触发这个信号.
void textEdited(const QString &text))	当QLineEdit中的⽂本改变时，发出此信号，text是新的⽂本。代码对⽂本的修改不能触发这个信号.