• 【Qt常用控件】—— 输入类控件


    目录

    1.1 Line Edit

    1.2 Text Edit

    1.3 Combo Box  

    1.4 Spin Box 

    1.5 Date Edit & Time Edit

    1.6 Dial

    1.7 Slider


    1.1 Line Edit

    QLineEdit是Qt中的一个控件,用于 接收和显示单行文本输入
    核心属性
    属性
    说明
    text
    输⼊框中的⽂本
    inputMask
    输⼊内容格式约束
    maxLength
    最⼤⻓度
    frame
    是否添加边框
    echoMode
    显⽰⽅式:
    QLineEdit::Normal :这是默认值,⽂本框会显⽰输⼊的⽂本。
    QLineEdit::Password :在这种模式下,输⼊的字符会被隐藏,
    通常⽤星号(*)或等号(=)代替。
    QLineEdit::NoEcho :在这种模式下,⽂本框不会显⽰任何输⼊的字符。
    cursorPosition
    光标所在位置
    alignment
    ⽂字对⻬⽅式, 设置⽔平和垂直⽅向的对⻬.
    dragEnabled
    是否允许拖拽
    readOnly
    是否是只读的(不允许修改)
    placeHolderText
    当输⼊框内容为空的时候, 显⽰什么样的提⽰信息
    clearButtonEnable
    是否会⾃动显⽰出 "清除按钮" .
    核心信号
    属性
    说明
    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是新的⽂本。
    代码对⽂本的修改不能触发这个信号
    代码示例: 录⼊个⼈信息
    1) 在界面上创建三个输入框和两个单选按钮, ⼀个普通按钮.
    • 三个输⼊框的 objectName lineEdit_name , lineEdit_password , lineEdit_phone
    • 两个单选按钮的 objectName radioButton_male , radioButton_female按钮的 objectName pushButton

    2) 编写 widget.cpp, 在构造函数中编写初始化代码.  

    1. Widget::Widget(QWidget *parent)
    2. : QWidget(parent)
    3. , ui(new Ui::Widget)
    4. {
    5. ui->setupUi(this);
    6. // 初始化第⼀个输⼊框
    7. ui->lineEdit_name->setPlaceholderText("请输⼊姓名");
    8. ui->lineEdit_name->setClearButtonEnabled(true);
    9. // 初始化第⼆个输⼊框
    10. ui->lineEdit_password->setPlaceholderText("请输⼊密码");
    11. ui->lineEdit_password->setClearButtonEnabled(true);
    12. ui->lineEdit_password->setEchoMode(QLineEdit::Password);
    13. // 初始化第三个输⼊框
    14. ui->lineEdit_phone->setPlaceholderText("请输⼊电话号码");
    15. ui->lineEdit_password->setClearButtonEnabled(true);
    16. // 验证⼿机号码必须是 11 位数字. 并且按照 "344" 的格式来输⼊.
    17. ui->lineEdit_phone->setInputMask("000-0000-0000");
    18. }
    3) 继续修改 widget.cpp, 给按钮添加 slot 函数
    1. void Widget::on_pushButton_clicked()
    2. {
    3. QString gender = ui->radioButton_male->isChecked() ? "男" : "⼥";
    4. qDebug() << "姓名: " << ui->lineEdit_name->text()
    5. << "密码: " << ui->lineEdit_password->text()
    6. << "性别: " << gender
    7. << "⼿机: " << ui->lineEdit_phone->text();
    8. }
    4) 执行程序, 可以看到, 随着用户输入内容之后, 点击按钮, 就能打印到输⼊的信息

    【注意】

    • inputMask 只能进⾏简单的输⼊格式校验. 实际开发中, 基于正则表达式的⽅式是更核⼼的⽅法.

    1.2 Text Edit

    QTextEdit是一个功能强大的多行文本编辑控件,适用于各种需要多行文本输入和显示的应用场景,如文档编辑、日志记录和聊天界面等。

    核心属性
    属性
    说明
    markdown
    输⼊框内持有的内容. ⽀持 markdown 格式. 能够⾃动的对markdown ⽂本进⾏渲染成 html
    html
    输⼊框内持有的内容. 可以⽀持⼤部分 html 标签. 包括 img 和 table 等.
    placeHolderText
    输⼊框为空时提⽰的内容.
    readOnly
    是否是只读的
    undoRedoEnable
    是否开启 undo / redo 功能.
    按下 ctrl + z 触发 undo
    按下 ctrl + y 触发 redo
    autoFormating
    开启⾃动格式化.
    tabstopWidth
    按下缩进占多少空间
    overwriteMode
    是否开启覆盖写模式
    acceptRichText
    是否接收富⽂本内容
    verticalScrollBarPolicy
    垂直⽅向滚动条的出现策略
    Qt::ScrollBarAsNeeded : 根据内容⾃动决定是否需要滚动条。这是默认值。
    Qt::ScrollBarAlwaysOff : 总是关闭滚动条。
    Qt::ScrollBarAlwaysOn : 总是显⽰滚动条。
    horizontalScrollBarPolicy
    ⽔平⽅向滚动条的出现策略
    Qt::ScrollBarAsNeeded : 根据内容⾃动决定是否需要滚动条。这是默认值。
    Qt::ScrollBarAlwaysOff : 总是关闭滚动条。
    Qt::ScrollBarAlwaysOn : 总是显⽰滚动条。
    核心信号
    信号
    说明
    textChanged()
    ⽂本内容改变时触发
    selectionChanged()
    选中范围改变时触发
    cursorPositionChanged()
    光标移动时触发
    undoAvailable(bool)
    可以进⾏ undo 操作时触发
    redoAvailable(bool)
    可以进⾏ redo 操作时触发
    copyAvaiable(bool)
    ⽂本被选中/取消选中时触发
    代码⽰例: 获取多⾏输⼊框的内容
    1) 创建⼀个多⾏输⼊框和⼀个label

    2) 给多⾏输⼊框添加 slot 函数. 处理 textChanged 信号.
    • 通过 toPlainText ⽅法获取到内部的⽂本.
    • 类似的, QTextEdit 还提供了 toMarkdown toHtml . 根据需要我们调整不同的获取⽅式.
    1. void Widget::on_textEdit_textChanged()
    2. {
    3. const QString& content = ui->textEdit->toPlainText();
    4. qDebug() << content;
    5. ui->label->setText(content);
    6. }

     3) 执⾏程序, 可以看到当输⼊框中的内容发⽣变化时, label 中的内容同步发⽣改变.


    1.3 Combo Box  

    QComboBox是一个常用的UI控件,适用于许多需要从预定义选项中选择的场景,如设置界面、过滤器和工具栏等。

    核心属性

    属性
    说明
    currentText
    当前选中的⽂本
    currentIndex

    当前选中的条⽬下标

    从 0 开始计算. 如果当前没有条⽬被选中, 值为 -1

    editable
    是否允许修改
    设为 true 时, QComboBox 的⾏为就⾮常接近 QLineEdit , 也可以设置 validator
    iconSize
    下拉框图标 (⼩三⻆) 的⼤⼩
    maxCount
    最多允许有多少个条⽬

    核心方法 

    ⽅法
    说明
    addItem(const QString&)
    添加⼀个条⽬
    currentIndex()

    获取当前条⽬的下标

    从 0 开始计算. 如果当前没有条⽬被选中, 值为 -1

    currentText()
    获取当前条⽬的⽂本内容.

    核心信号

    ⽅法
    说明
    activated(int)
    activated(const QString & text)
    当⽤⼾选择了⼀个选项时发出.
    这个时候相当于⽤⼾点开下拉框, 并且⿏标划过某个选项.
    此时还没有确认做出选择.
    currentIndexChanged(int)
    currentIndexChanged(const QString & text)
    当前选项改变时发出.
    此时⽤⼾已经明确的选择了⼀个选项.
    ⽤⼾操作或者通过程序操作都会触发这个信号.
    editTextChanged(const QString &
    text)
    当编辑框中的⽂本改变时发(editable 为 true 时有效)
    代码⽰例: 使⽤下拉框模拟⻨当劳点餐
    1) 在界⾯上创建三个下拉框, 和⼀个按钮.

    2) 编写 widget.cpp, 初始化三个下拉框的内容
    1. Widget::Widget(QWidget *parent)
    2. : QWidget(parent)
    3. , ui(new Ui::Widget)
    4. {
    5. ui->setupUi(this);
    6. ui->comboBox->addItem("巨⽆霸");
    7. ui->comboBox->addItem("⻨辣鸡腿堡");
    8. ui->comboBox_2->addItem("薯条");
    9. ui->comboBox_2->addItem("⻨辣鸡翅");
    10. ui->comboBox_3->addItem("可乐");
    11. ui->comboBox_3->addItem("雪碧");
    12. }
    3) 编写 widget.cpp, 给按钮添加 slot 函数
    1. void Widget::on_pushButton_clicked()
    2. {
    3. qDebug() << "汉堡选择: " << ui->comboBox->currentText();
    4. qDebug() << "⼩⻝选择: " << ui->comboBox_2->currentText();
    5. qDebug() << "饮料选择: " << ui->comboBox_3->currentText();
    6. }
    4) 执⾏程序, 可以看到, 在点击确定按钮时, 就能获取到当前下拉框中选中的内容.

    1. Qt 中也提供了 QFile 实现读写⽂件的功能. 当然使⽤ C++ 标准库的 std::fstream 也是完全可 以的.
    2. 之所以存在两套, 是因为 Qt 诞⽣较早 (1991 年左右), 此时 C++ 还没有完成 "标准化" 的⼯作, C++ 标准库这样的概念⾃然也没有诞⽣.
    3. 因此 Qt 就⾃⼰打造了⼀套库, 实现了字符串, 容器, ⽂件操作, 多线程, ⽹络操作, 定时器, 正则 表达式等内容.
    (由于 C++ 标准委员会的不作为, ⾄今仍然有些 Qt 提供的功能, 是标准库不具备的)

    1.4 Spin Box 

    使⽤ QSpinBox 或者 QDoubleSpinBox 表示 "微调框", 它是带有按钮的输⼊框. 可以⽤来输入整数/浮点数. 通过点击按钮来修改数值大小.
    • 由于 SpinBox QDoubleSpinBox ⽤法基本相同, 就只介绍 SpinBox 的使⽤了.

    • Spin 英⽂原意为 "旋转". 此处引申成 "微调".
    • 事实上很多术语在翻译的时候, 不⼀定⾮要按照原始的翻译来表⽰, 更追求的是 "信达雅".
    • 举个例⼦, 地铁上的 "Priority Seat" 会翻译成 "爱⼼专座", ⽽不是 "优先座位".

    QSpinBox 关键属性

    信号
    说明
    value 
    存储的数值.
    singleStep
    每次调整的 "步⻓". 按下⼀次按钮数据变化多少.
    displayInteger
    数字的进制. 例如 displayInteger 设为 10, 则是按照 10 进制表⽰. 设为 2 则为 2进制表⽰.
    minimum
    最⼩值
    maximum
    最⼤值
    suffix
    后缀
    prefix
    前缀
    wrapping
    是否允许换⾏
    frame
    是否带边框
    alignment
    ⽂字对⻬⽅式
    readOnly
    是否允许修改
    buttonSymbo

    按钮上的图标:

    UpDownArrows 上下箭头形式
    PlusMinus 加减号形式
    NoButtons 没有按钮
    accelerated (加速的)
    按下按钮时是否为快速调整模式
    correctionMode
    输⼊有误时如何修正.
    QAbstractSpinBox::CorrectToPreviousValue : 如果⽤⼾输⼊了⼀个⽆效的值(例如,在只能显⽰正整数的SpinBox中输⼊了负数),那么SpinBox会恢复为上⼀个有效值。例如,如果SpinBox的初始值是1,⽤⼾输⼊了-1(⽆效),然后SpinBox会恢复为1。
    QAbstractSpinBox::CorrectToNearestValue : 如果⽤⼾输⼊了⼀个⽆效的值,SpinBox会恢复为最接近的有效值。例如,如果SpinBox的初始值是1,⽤⼾输⼊了-1(⽆效),那么SpinBox会恢复为0。
    keyboardTrack
    是否开启键盘跟踪:
    设为 true, 每次在输⼊框输⼊⼀个数字, 都会触发⼀次 valueChanged() 和 textChanged() 信号.
    设为 false, 只有在最终按下 enter 或者输⼊框失去焦点, 才会触发valueChanged() 和 textChanged() 信号.

     核心信号

    信号
    说明
    textChanged(QString)
    微调框的⽂本发⽣改变时会触发.
    参数 QString 带有 前缀 和 后缀.
    valueChanged(int)
    微调框的⽂本发⽣改变时会触发.
    参数 int, 表⽰当前的数值.
    代码⽰例: 调整⻨当劳购物⻋中的份数.
    1) 在界面上创建下列内容
    • 三个下拉框: objectName comboBox comboBox_3
    • 三个微调框: objectName spinBox spinBox_3
    • ⼀个按钮: objectName pushButton

    2) 编写代码, 修改 widget.cpp, 给下拉框设置初始值.  

    1. Widget::Widget(QWidget *parent)
    2. : QWidget(parent)
    3. , ui(new Ui::Widget)
    4. {
    5. ui->setupUi(this);
    6. // 初始化下拉框
    7. ui->comboBox->addItem("巨⽆霸");
    8. ui->comboBox->addItem("⻨辣鸡腿堡");
    9. ui->comboBox_2->addItem("薯条");
    10. ui->comboBox_2->addItem("⻨辣鸡翅");
    11. ui->comboBox_3->addItem("可乐");
    12. ui->comboBox_3->addItem("雪碧");
    13. // 初始化微调框
    14. ui->spinBox->setValue(1);
    15. ui->spinBox->setRange(1, 5);
    16. ui->spinBox_2->setValue(1);
    17. ui->spinBox_2->setRange(1, 5);
    18. ui->spinBox_3->setValue(1);
    19. ui->spinBox_3->setRange(1, 5);
    20. }
    3) 编写代码, 给按钮添加 slot 函数
    1. void Widget::on_pushButton_clicked()
    2. {
    3. qDebug() << "当前下单的内容: "
    4. << ui->comboBox->currentText() << ": " << ui->spinBox->value()
    5. << ui->comboBox_2->currentText() << ": " << ui->spinBox_2->value()
    6. << ui->comboBox_3->currentText() << ": " << ui->spinBox_3->value();
    7. }
    4) 执⾏程序, 可以看到当⽤⼾选择不同的内容时, 点击按钮就能获取到对应的结果. 同时我们也⽆法输⼊⼀些超出范围的⾮法值.


    1.5 Date Edit & Time Edit

    使⽤ QDateEdit 作为⽇期的微调框.

    使⽤ QDateEdit 作为⽇期的微调框.

    使⽤ QDateTimeEdit 作为时间⽇期的微调框.

    这⼏个控件⽤法⾮常相似, 我们以 QDateTimeEdit 为例进⾏介绍.
    QDateTimeEdit 核心属性
    属性
    说明
    dateTime
    时间⽇期的值. 形如 2000/1/1 0:00:00
    date
    单纯⽇期的值. 形如 2001/1/1
    time
    单纯时间的值. 形如 0:00:00
    displayFormat
    时间⽇期格式. 形如 yyyy/M/d H:mm
    y 表⽰年份
    M 表⽰⽉份
    d 表⽰⽇期
    H 表⽰⼩时
    m 表⽰分钟
    s 表⽰秒
    注意: 这⾥的格式化符号的含义, 不要记忆. 不同语⾔/库的设定规则是存在差异的. ⼀定是⽤的时候再去查.
    minimumDateTime
    最⼩时间⽇期
    maximumDateTime
    最⼤时间⽇期
    timeSpec
    Qt::LocalTime :显⽰本地时间。
    Qt::UTC :显⽰协调世界时(UTC)。
    Qt::OffsetFromUTC :显⽰相对于UTC的偏移量(时差).
    关于 本地时间(LocalTime) 和 协调世界时(UTC)
    1. UTC 时间是⼀个基于原⼦钟的标准时间. 不受地球的⾃转周期影响. 和格林威治时间 (GMT)是⾮常接近的. 科学家会通过精密的设备来测量并维护.
    2. 咱们的计算机内部使⽤的时间就是基于 UTC 时间.
    3. 本地时间则是基于不同的时区, 对 UTC 时间做出了⼀些调整. ⽐如咱们使⽤的北京时间, 位于 "东⼋区", 就需要在 UTC 时间基础上 +8 个⼩时的时差.

      核心信号

    信号
    说明
    dateChanged(QDate)
    ⽇期改变时触发.
    timeChanged(QTime)
    时间改变时触发.
    dateTimeChanged(QDateTi
    me)
    时间⽇期任意⼀个改变时触发.
    代码⽰例: 实现⽇期计算器
    1) 在界面上创建两个 QDateTimeEdit 和⼀个按钮, ⼀个 label QDateTimeEdit 的 objectName dateTimeEdit_old dateTimeEdit_new

    2) 编写计算按钮的 slot 函数
    • 使⽤ daysTo 函数可以计算两个⽇期的天数.
    • 使⽤ secsTo 函数可以计算两个时间的秒数.
    • 通过 (秒数 / 3600) 换算成⼩时数, 再余上 24 得到零⼏个⼩时.
    • 使⽤ QString::number 把整数转成 QString 进⾏拼接.
    1. void Widget::on_pushButton_clicked()
    2. {
    3. // 获取到两个时间框的时间⽇期
    4. QDateTime timeOld = ui->dateTimeEdit_old->dateTime();
    5. QDateTime timeNew = ui->dateTimeEdit_new->dateTime();
    6. // 计算⽇期差值
    7. int days = timeOld.daysTo(timeNew);
    8. int hours = (timeOld.secsTo(timeNew) / 3600) % 24;
    9. // 设置 label 的内容
    10. QString text = QString("爱你已经持续了 ") + QString::number(days) +
    11. QString(" 天 零 ")+ QString::number(hours) + QString(" 个⼩时!");
    12. ui->label->setText(text);
    13. }
    3) 执⾏程序, 观察结果


    1.6 Dial

    使⽤ QDial 表⽰⼀个 旋钮.
    有些程序, 通过⿏标拖动旋钮旋转, 即可完成⼀些相关的设置.

    核心属性

    属性
    说明
    value
    持有的数值.
    minimum
    最⼩值
    maximum
    最⼤值
    singleStep
    按下⽅向键的时候改变的步⻓.
    pageStep
    按下 pageUp / pageDown 的时候改变的步⻓.
    sliderPosition
    界⾯上旋钮显⽰的 初始位置
    tracking
    外观是否会跟踪数值变化.
    默认值为 true. ⼀般不需要修改.
    wrapping
    是否允许循环调整.
    即数值如果超过最⼤值, 是否允许回到最⼩值.
    (调整过程能否 "套圈")
    notchesVisible
    是否显⽰ 刻度线
    notchTarget
    刻度线之间的相对位置.
    数字越⼤, 刻度线越稀疏.
    核心信号
    属性
    说明
    valueChanged(int)
    数值改变时触发
    rangeChanged(int, int)
    范围变化时触发
    代码⽰例: 调整窗⼝透明度
    1) 在界⾯上创建⼀个旋钮和⼀个 label

    2) 编写 widget.cpp, 对旋钮初始化
    1. Widget::Widget(QWidget *parent)
    2. : QWidget(parent)
    3. , ui(new Ui::Widget)
    4. {
    5. ui->setupUi(this);
    6. // 设置可以循环旋转
    7. ui->dial->setWrapping(true);
    8. // 设置刻度线可⻅
    9. ui->dial->setNotchesVisible(true);
    10. // 设置最⼤值为
    11. ui->dial->setMaximum(100);
    12. // 设置最⼩值为
    13. ui->dial->setMinimum(0);
    14. // 设置初始值为
    15. ui->dial->setValue(100);
    16. }
    3) 编写 widget.cpp, 设置旋钮的 valueChanged slot 函数
    1. void Widget::on_dial_valueChanged(int value)
    2. {
    3. ui->label->setText(QString("当前不透明度为: ") + QString::number(value));
    4. this->setWindowOpacity((double)value / 100);
    5. }
    4) 运⾏程序, 观察效果. 可以看到随着拖动旋钮旋转, 不透明度发⽣明显变化.


    1.7 Slider

    使⽤ QSlider 表⽰⼀个滑动条.

    • QSlider QDial 都是继承⾃ QAbstractSlider , 因此⽤法上基本相同.

    核心属性

    属性
    说明
    value
    持有的数值.
    minimum
    最⼩值
    maximum
    最⼤值
    singleStep
    按下⽅向键的时候改变的步⻓.
    pageStep
    按下 pageUp / pageDown 的时候改变的步⻓.
    sliderPosition
    滑动条显⽰的初始位置
    tracking

    外观是否会跟踪数值变化.

    默认值为 true. ⼀般不需要修改.

    orientation
    滑动条的⽅向是⽔平还是垂直
    invertedAppearance
    是否要翻转滑动条的⽅向
    tickPosition
    刻度的位置.
    tickInterval
    刻度的密集程度.

    核心信号

    属性
    说明
    valueChanged(int)
    数值改变时触发
    rangeChanged(int, int)
    范围变化时触发
    代码⽰例: 调整窗⼝⼤⼩
    1) 在界面上创建两个滑动条, 分别是⽔平和垂直滑动条. objectName 分别为 horizontalSlider verticalSlider

    • horizontal 这个单词还⽐较复杂, ⼤家要能会读会拼. 知名 3A ⼤作 "地平线5" 就是⽤的这个单词的名词形式.

    2) 编写代码初始化滑动条
    1. Widget::Widget(QWidget *parent)
    2. : QWidget(parent)
    3. , ui(new Ui::Widget)
    4. {
    5. ui->setupUi(this);
    6. ui->horizontalSlider->setMinimum(500);
    7. ui->horizontalSlider->setMaximum(2000);
    8. ui->horizontalSlider->setSingleStep(100);
    9. ui->horizontalSlider->setValue(800);
    10. ui->verticalSlider->setMinimum(500);
    11. ui->verticalSlider->setMaximum(1500);
    12. ui->verticalSlider->setSingleStep(100);
    13. ui->verticalSlider->setValue(600);
    14. // 翻转朝向, 默认滑块从下向上增⻓, 改成从上往下增⻓.
    15. ui->verticalSlider->setInvertedAppearance(true);
    16. }

    3) 编写滑动条的 valueChanged slot 函数

    1. void Widget::on_horizontalSlider_valueChanged(int value)
    2. {
    3. QRect rect = this->geometry();
    4. this->setGeometry(rect.x(), rect.y(), value, rect.height());
    5. qDebug() << value;
    6. }
    7. void Widget::on_verticalSlider_valueChanged(int value)
    8. {
    9. QRect rect = this->geometry();
    10. this->setGeometry(rect.x(), rect.y(), rect.width(), value);
    11. qDebug() << value;
    12. }
    4) 执⾏程序, 可以看到调整滑动条, 窗⼝⼤⼩就会随之改变.


     以上就是关于本期输入类控件的全部知识!!!

  • 相关阅读:
    人生苦短,我用Python 七:如何在flask文档在return后,继续执行文档函数?
    Locust 之 User
    Java SE String类(一):常用方法(上)
    VoLTE基础自学系列 | VoLTE呼叫流程之PSTN打VoLTE
    运动蓝牙耳机哪个品牌好、运动蓝牙耳机推荐
    Matlab怎么画局部放大图
    Python在WRF模型自动化运行及前后处理中的应用
    Uniapp云开发(Uniapp入门)
    德人合科技|办公电脑文件资料防泄密软件
    FFmpeg入门 - 视频播放
  • 原文地址:https://blog.csdn.net/m0_56069910/article/details/138152797