文章目录
- Qt
-
- [5. Qt显示类控件](#5. Qt显示类控件)
-
- [Line Edit](#Line Edit)
- [Text Edit](#Text Edit)
- [Combo Box](#Combo Box)
- [Spin Box](#Spin Box)
- QDateTimeEdit
- Dial
- Slider
Qt
5. Qt显示类控件
Line Edit
QLineEdit 用于表示单行输入框。可以输入一段文本，但是不能换行。
| 属性 | 说明 |
|---|---|
| text | 输入框中的文本 |
| inputMask | 输入内容格式约束 |
| maxLength | 最大长度 |
| frame | 是否添加边框 |
| echoMode | 显示方式 |
| QLineEdit::Normal | 这是默认值，文本框会显示输入的文本 |
| QLineEdit::Password | 在这种模式下，输入的字符会被隐藏，通常用星号（*）或等号（=）代替 |
| QLineEdit::NoEcho | 在这种模式下，文本框不会显示任何输入的字符 |
| cursorPosition | 光标所在位置 |
| alignment | 文字对齐方式, 设置水平和垂直方向的对齐 |
| dragEnabled | 是否允许拖拽 |
| readOnly | 是否是只读的(不允许修改) |
| 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参数表示新的文本内容。这个信号不会由代码对文本的修改触发。 |
-
代码示例：使用 QLineEdit 创建编辑框，并且用户输入信息可以回响。
-
setPlaceholderText()：设置默认文字；setEchoMode(QLineEdit:: )：设置文字样式；setInputMask()：设置文字格式。
- 连接槽函数，实现输入信息后的回响操作。
- 代码示例：判断两次输入信息是否一致。
- 使用 QString 接收文字并且进行判断。
Text Edit
QTextEdit 表示多行输入框。也是一个富文本 & markdown 编辑器。并且能在内容超出编辑框范围时自动提供滚动条。
| 属性 | 说明 |
|---|---|
| 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) | 文本被选中 / 取消选中时触发。 |
- 代码示例：在多行输入框中输入信息，可以显示到 QLabel 中。
- 建立连接关系。
- selectionChanged()：是选中改变时触发的信号。
- 输入位置改变时触发cursorPositionChanged()信号。
-
按下ctrl+z触发undoAvailable()。
-
按下ctrl+y触发redoAvailable()。
- 选中文本时触发copyAvailable()。
Combo Box
QComboBox 表示下拉框。
| 属性 | 说明 |
|---|---|
| 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 时有效）。 |
-
addItem(QString)可以向 QComboBox 中添加选项。
-
连接槽函数。
Spin Box
使用 QSpinBox 或者 QDoubleSpinBox 表示 "微调框", 它是带有按钮的输入框。可以用来输入整数 / 浮点数。通过点击按钮来修改数值大小。
| 属性 | 说明 |
|---|---|
| value | 存储的数值。 |
| singleStep | 每次调整的 "步长"。按下一次按钮数据变化多少。 |
| displayInteger | 数字的进制。例如 displayInteger 设为 10，则是按照 10 进制表示。设为 2 则为 2 进制表示。 |
| minimum | 最小值。 |
| maximum | 最大值。 |
| suffix | 后缀。 |
| prefix | 前缀。 |
| wrapping | 是否允许换行。 |
| frame | 是否带边框。 |
| alignment | 文字对齐方式。 |
| readOnly | 是否允许修改。 |
| buttonSymbol | 按钮上的图标。 |
| 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，表示当前的数值。 |
- 创建 QSpinBox 微调框。
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 | 最大时间日期。 |
| Qt::LocalTime | 显示本地时间。 |
| Qt::UTC | 显示协调世界时（UTC）。 |
| Qt::OffsetFromUTC | 显示相对于 UTC 的偏移量 (时差)。 |
- 创建 QDateTimeEdit 日期微调框。
Dial
使用 QDial 表示一个旋钮。
| 属性 | 说明 |
|---|---|
| value | 持有的数值。 |
| minimum | 最小值。 |
| maximum | 最大值。 |
| singleStep | 按下方向键的时候改变的步长。 |
| pageStep | 按下 pageUp/pageDown 的时候改变的步长。 |
| sliderPosition | 界面上旋钮显示的初始位置。 |
| tracking | 外观是否会跟踪数值变化。默认值为 true。一般不需要修改。 |
| wrapping | 是否允许循环调整。即数值如果超过最大值，是否允许回到最小值。（调整过程能否 "套圈"）。 |
| notchesVisible | 是否显示刻度线。 |
| notchTarget | 刻度线之间的相对位置。数字越大，刻度线越稀疏。 |
| 信号 | 说明 |
|---|---|
| valueChanged (int) | 数值改变时触发。 |
| rangeChanged (int, int) | 范围变化时触发。 |
- 创建一个旋钮 QDial 。
Slider
使用 QSlider 表示一个滑动条。
| 属性 | 说明 |
|---|---|
| value | 持有的数值。 |
| minimum | 最小值。 |
| maximum | 最大值。 |
| singleStep | 按下方向键的时候改变的步长。 |
| pageStep | 按下 pageUp/pageDown 的时候改变的步长。 |
| sliderPosition | 滑动条显示的初始位置。 |
| tracking | 外观是否会跟踪数值变化。默认值为 true。一般不需要修改。 |
| orientation | 滑动条的方向是水平还是垂直。 |
| invertedAppearance | 是否要翻转滑动条的方向。 |
| tickPosition | 刻度的位置。 |
| tickInterval | 刻度的密集程度。 |
| 信号 | 说明 |
|---|---|
| valueChanged (int) | 数值改变时触发。 |
| rangeChanged (int, int) | 范围变化时触发。 |
- 创建一个滑动条 QSlider 。
