详细学习Pyqt5的20种输入控件（Input Widgets）_pyqt5输入框控件

Pyqt5相关文章:
快速掌握Pyqt5的三种主窗口
快速掌握Pyqt5的2种弹簧
快速掌握Pyqt5的5种布局
快速弄懂Pyqt5的5种项目视图（Item View）
快速弄懂Pyqt5的4种项目部件（Item Widget）
快速掌握Pyqt5的6种按钮
快速掌握Pyqt5的10种容器（Containers）
快速掌握Pyqt5的20种输入控件（Input Widgets）
快速掌握Pyqt5的9种显示控件
详细学习Pyqt5中的5种布局方式
详细学习Pyqt5中的6种按钮
详细学习Pyqt5中的2种弹簧
详细学习Pyqt5的5种项目视图（Item View）
详细学习Pyqt5的4种项目部件（Item Widget）
详细学习Pyqt5的20种输入控件（Input Widgets）
详细学习Pyqt5的9种显示控件
详细学习Pyqt5的10种容器（Containers）
详细学习PyQt5与数据库交互
详细学习PyQt5中的多线程
快速学习PyQt5的动画和图形效果
快速学习PyQt5的高级自定义控件
快速学会绘制Pyqt5中的所有图（上）
快速学会绘制Pyqt5中的所有图（下）
通过“待办事项列表项目”快速学习Pyqt5的一些特性
待续。。。

在PyQt5应用程序中，输入和控制控件是用户与应用交互的关键元素。本文将深入探讨PyQt5中一些常用的输入和控制控件，包括QLineEdit、QTextEdit、QSpinBox等，以帮助开发者更好地理解和运用这些控件，提升用户体验和界面交互的质量。通过详细介绍这些控件的特性、用法和实际应用案例，我们将为开发者提供在PyQt5应用中优雅处理用户输入和控制的技能和洞见。

1. QLineEdit - 基础文本输入

QLineEdit是PyQt5中用于单行文本输入的基本控件。本节将深入探讨QLineEdit的基础用法以及如何通过输入掩码和验证器来增强其功能。

基本用途：

QLineEdit用于接收用户的单行文本输入。它是用户与应用程序进行简单交互的关键工具，适用于需要用户输入用户名、密码、搜索关键字等场景。

单行文本输入：

使用QLineEdit实现单行文本输入非常简单。通过以下代码示例，我们展示了如何创建一个接受用户姓名输入的QLineEdit：

from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit, QVBoxLayout

class NameInputApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建标签和文本输入框
        label = QLabel('请输入您的姓名:')
        line_edit = QLineEdit()

        # 将标签和文本输入框添加到布局
        layout.addWidget(label)
        layout.addWidget(line_edit)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('姓名输入应用')
        self.show()

if __name__ == '__main__':
    app = QApplication([])
    window = NameInputApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

在这个示例中，我们创建了一个简单的窗口，包含一个标签和一个QLineEdit，用户可以在该输入框中输入姓名。

输入掩码和验证器：

QLineEdit支持输入掩码和验证器，以限制用户的输入。例如，我们可以通过以下方式限制用户只能输入数字：

# 创建只允许输入数字的QLineEdit
numeric_line_edit = QLineEdit()
numeric_line_edit.setInputMask('D')
1
2
3

这将使QLineEdit只接受数字的输入。此外，可以使用验证器来执行更灵活的验证。例如，我们可以创建一个只允许输入0到100的验证器：

from PyQt5.QtGui import QIntValidator

# 创建验证器
validator = QIntValidator(0, 100)

# 将验证器应用于QLineEdit
numeric_line_edit.setValidator(validator)
1
2
3
4
5
6
7

通过这样的设置，用户只能输入介于0和100之间的整数。

通过QLineEdit的输入掩码和验证器，我们能够在用户输入时实现更加精确和合法的文本控制，提高应用的稳定性和用户体验。

2. QTextEdit - 多行文本编辑

QTextEdit是PyQt5中用于多行文本编辑的强大控件。本节将深入讨论QTextEdit的高级功能，特别是富文本编辑，并展示如何处理多行文本和格式化选项。

富文本编辑：

QTextEdit不仅支持普通文本输入，还允许用户进行富文本编辑。这意味着用户可以为文本应用不同的字体、颜色、样式和对齐方式。

以下是一个展示如何在QTextEdit中使用富文本的示例：

from PyQt5.QtWidgets import QApplication, QWidget, QTextEdit, QVBoxLayout

class RichTextEditorApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建QTextEdit用于富文本编辑
        rich_text_edit = QTextEdit()

        # 在QTextEdit中插入富文本
        rich_text_edit.setHtml("<h1 style='color:blue'>Hello</h1><p>This is a <b>rich</b> text example.</p>")

        # 将QTextEdit添加到布局
        layout.addWidget(rich_text_edit)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('富文本编辑器')
        self.show()

if __name__ == '__main__':
    app = QApplication([])
    window = RichTextEditorApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

在这个示例中，我们创建了一个富文本编辑器窗口，使用setHtml方法在QTextEdit中插入富文本。用户可以通过设置字体颜色、样式等来实现更加丰富的文本编辑。

处理多行文本：

QTextEdit也非常适用于处理大段的多行文本，例如日志记录或长文本的显示。通过以下方式，我们可以在QTextEdit中添加多行文本：

# 创建QTextEdit用于多行文本
multi_line_text_edit = QTextEdit()
multi_line_text_edit.setPlainText("This is a\nmulti-line\ntext example.")
1
2
3

在这个示例中，我们使用setPlainText方法设置QTextEdit的文本内容，其中包含多行文本，每行以换行符分隔。

格式化选项：

QTextEdit还支持格式化选项，例如文本的粗体、斜体、下划线等。以下是一个展示如何在QTextEdit中应用格式化选项的示例：

from PyQt5.QtGui import QTextCursor

# 创建QTextEdit
formatted_text_edit = QTextEdit()

# 在QTextEdit中插入文本
formatted_text_edit.setPlainText("This is an example of formatted text.")

# 获取QTextCursor
cursor = formatted_text_edit.textCursor()

# 移动到文本的起始位置
cursor.movePosition(QTextCursor.Start)

# 应用粗体
cursor.mergeCharFormat(QTextCharFormat().setFontWeight(QFont.Bold))

# 应用斜体
cursor.mergeCharFormat(QTextCharFormat().setFontItalic(True))

# 应用下划线
cursor.mergeCharFormat(QTextCharFormat().setFontUnderline(True))
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

通过使用QTextCursor，我们可以在文本中移动并应用不同的格式化选项。

通过QTextEdit的富文本编辑和格式化选项，我们能够创建功能强大的文本编辑器，满足各种应用场景的需求。

3. QSpinBox & QDoubleSpinBox - 数字输入

QSpinBox和QDoubleSpinBox是用于数字输入的两个常用控件。本节将介绍这两个控件的基本功能，包括如何限制和格式化数字输入，以及如何自定义步长和范围。

QSpinBox - 整数输入:

QSpinBox用于输入整数值，用户可以通过上下箭头或手动输入来选择整数。以下是一个基本的QSpinBox示例：

from PyQt5.QtWidgets import QApplication, QWidget, QSpinBox, QVBoxLayout

class SpinBoxApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建QSpinBox
        spin_box = QSpinBox()

        # 设置范围
        spin_box.setRange(0, 100)

        # 设置当前值
        spin_box.setValue(50)

        # 将QSpinBox添加到布局
        layout.addWidget(spin_box)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('整数输入')
        self.show()

if __name__ == '__main__':
    app = QApplication([])
    window = SpinBoxApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

在这个示例中，我们创建了一个范围为0到100的QSpinBox，并设置了初始值为50。

QDoubleSpinBox - 浮点数输入:

QDoubleSpinBox与QSpinBox类似，但用于输入浮点数值。以下是一个基本的QDoubleSpinBox示例：

from PyQt5.QtWidgets import QApplication, QWidget, QDoubleSpinBox, QVBoxLayout

class DoubleSpinBoxApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建QDoubleSpinBox
        double_spin_box = QDoubleSpinBox()

        # 设置范围和步长
        double_spin_box.setRange(0.0, 1.0)
        double_spin_box.setSingleStep(0.1)

        # 设置当前值
        double_spin_box.setValue(0.5)

        # 将QDoubleSpinBox添加到布局
        layout.addWidget(double_spin_box)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('浮点数输入')
        self.show()

if __name__ == '__main__':
    app = QApplication([])
    window = DoubleSpinBoxApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

在这个示例中，我们创建了一个范围为0.0到1.0、步长为0.1的QDoubleSpinBox，并设置了初始值为0.5。

限制和格式化输入:

除了设置范围和步长外，我们还可以通过以下方式限制和格式化用户的输入：

# 设置最大最小值
spin_box.setRange(10, 100)

# 设置步长
double_spin_box.setSingleStep(0.01)

# 设置特定格式
double_spin_box.setDecimals(2)  # 保留两位小数
1
2
3
4
5
6
7
8

通过这些设置，我们可以确保用户输入的数字符合特定的要求。

QSpinBox和QDoubleSpinBox是在PyQt5应用中常用的控件，适用于需要数字输入的场景。

4. QComboBox - 下拉选择列表

QComboBox是PyQt5中常用的控件之一，用于提供下拉选择列表的功能。以下是QComboBox的用途、功能以及如何进行基本操作的介绍。

用途和功能:

QComboBox用于展示用户可以选择的多个选项，并允许用户从中选择一个或输入自定义内容。常见的用途包括选择列表、国家/地区选择、颜色选择等。

基本操作:

以下是一些基本操作，演示如何使用QComboBox添加、移除和编辑项目。

from PyQt5.QtWidgets import QApplication, QWidget, QComboBox, QVBoxLayout

class ComboBoxApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建QComboBox
        combo_box = QComboBox()

        # 添加项目
        combo_box.addItem('Option 1')
        combo_box.addItem('Option 2')
        combo_box.addItem('Option 3')

        # 获取当前选择的项
        current_item = combo_box.currentText()
        print(f'Current Item: {current_item}')

        # 移除指定位置的项
        combo_box.removeItem(1)

        # 插入新项到指定位置
        combo_box.insertItem(1, 'New Option')

        # 编辑指定位置的项
        combo_box.setItemText(0, 'Updated Option')

        # 将QComboBox添加到布局
        layout.addWidget(combo_box)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('下拉选择列表')
        self.show()

if __name__ == '__main__':
    app = QApplication([])
    window = ComboBoxApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

在这个示例中，我们创建了一个包含三个选项的QComboBox，并演示了添加、移除、编辑项目的操作。通过currentText()方法，我们还可以获取当前选择的项。

可编辑项:

QComboBox还支持可编辑的模式，允许用户输入自定义内容。要启用可编辑模式，可以使用setEditable(True)方法。

# 启用可编辑模式
combo_box.setEditable(True)
1
2

启用可编辑模式后，用户可以在下拉框中输入文本，而不仅仅限于选择预定义的项目。

QComboBox是一个灵活且常用的控件，适用于许多用户界面场景。通过使用QComboBox，用户可以方便地从预定义的选项中进行选择或输入自定义内容。

5. QSlider & QDial - 滑动选择器和旋钮

QSlider和QDial是PyQt5中用于实现滑动选择和旋钮功能的控件。以下是这两个控件的使用方法和定制示例。

QSlider - 滑动选择器

QSlider用于通过滑块选择一个数值范围。以下是QSlider的基本用法和一些定制操作。

from PyQt5.QtWidgets import QApplication, QWidget, QSlider, QVBoxLayout
from PyQt5.QtCore import Qt

class SliderApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建QSlider
        slider = QSlider(Qt.Horizontal)

        # 设置范围
        slider.setMinimum(0)
        slider.setMaximum(100)

        # 设置初始值
        slider.setValue(50)

        # 设置刻度位置和间隔
        slider.setTickPosition(QSlider.TicksBelow)
        slider.setTickInterval(10)

        # 连接值变化的信号到槽函数
        slider.valueChanged.connect(self.on_slider_change)

        # 将QSlider添加到布局
        layout.addWidget(slider)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('滑动选择器')
        self.show()

    def on_slider_change(self, value):
        print(f'Slider Value: {value}')

if __name__ == '__main__':
    app = QApplication([])
    window = SliderApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

在这个示例中，我们创建了一个水平方向的QSlider，设置了范围、初始值和刻度。通过连接valueChanged信号到槽函数，我们可以捕获滑块值的变化。

QDial - 旋钮

QDial用于通过旋转选择一个数值范围。以下是QDial的基本用法和一些定制操作。

from PyQt5.QtWidgets import QApplication, QWidget, QDial, QVBoxLayout
from PyQt5.QtCore import Qt

class DialApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建QDial
        dial = QDial()

        # 设置范围
        dial.setMinimum(0)
        dial.setMaximum(100)

        # 设置初始值
        dial.setValue(50)

        # 连接值变化的信号到槽函数
        dial.valueChanged.connect(self.on_dial_change)

        # 将QDial添加到布局
        layout.addWidget(dial)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('旋钮')
        self.show()

    def on_dial_change(self, value):
        print(f'Dial Value: {value}')

if __name__ == '__main__':
    app = QApplication([])
    window = DialApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

在这个示例中，我们创建了一个QDial，同样设置了范围和初始值，并连接了valueChanged信号。用户可以通过旋转旋钮来选择数值。

定制样式:

要定制QSlider和QDial的样式，可以使用样式表（StyleSheet）。以下是一个简单的样式表示例，将滑块的背景颜色和滑块的样式进行了定制。

slider.setStyleSheet("QSlider::groove:horizontal { background: #b2bec3; height: 10px; } "
                     "QSlider::handle:horizontal { background: #d63031; width: 20px; margin: -5px 0; }")
1
2

通过使用样式表，可以根据应用的设计需求自定义控件的外观。

QSlider和QDial是在用户界面中实现交互选择的重要工具，通过合适的定制，可以使其融入各种应用场景。

6. QRadioButton & QCheckBox - 选择按钮

QRadioButton和QCheckBox是PyQt5中用于实现选择按钮的控件。以下是这两个控件的基本使用和一些定制示例。

QRadioButton - 单选按钮

QRadioButton用于在一组中选择一个选项。以下是QRadioButton的基本用法和一些定制操作。

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QRadioButton

class RadioButtonApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建QRadioButton
        radio_btn1 = QRadioButton('Option 1')
        radio_btn2 = QRadioButton('Option 2')
        radio_btn3 = QRadioButton('Option 3')

        # 设置默认选中
        radio_btn2.setChecked(True)

        # 连接选中状态变化的信号到槽函数
        radio_btn1.toggled.connect(self.on_radio_toggled)
        radio_btn2.toggled.connect(self.on_radio_toggled)
        radio_btn3.toggled.connect(self.on_radio_toggled)

        # 将QRadioButton添加到布局
        layout.addWidget(radio_btn1)
        layout.addWidget(radio_btn2)
        layout.addWidget(radio_btn3)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('单选按钮')
        self.show()

    def on_radio_toggled(self):
        sender = self.sender()
        if sender.isChecked():
            print(f'Selected Option: {sender.text()}')

if __name__ == '__main__':
    app = QApplication([])
    window = RadioButtonApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

在这个示例中，我们创建了三个QRadioButton，设置了它们的文本和默认选中状态。通过连接toggled信号到槽函数，我们可以捕获单选按钮的状态变化。

QCheckBox - 复选框

QCheckBox用于允许用户选择或取消选择一个或多个选项。以下是QCheckBox的基本用法和一些定制操作。

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QCheckBox

class CheckBoxApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建QCheckBox
        check_box1 = QCheckBox('Option 1')
        check_box2 = QCheckBox('Option 2')
        check_box3 = QCheckBox('Option 3')

        # 设置默认选中
        check_box2.setChecked(True)

        # 连接状态变化的信号到槽函数
        check_box1.stateChanged.connect(self.on_check_state_changed)
        check_box2.stateChanged.connect(self.on_check_state_changed)
        check_box3.stateChanged.connect(self.on_check_state_changed)

        # 将QCheckBox添加到布局
        layout.addWidget(check_box1)
        layout.addWidget(check_box2)
        layout.addWidget(check_box3)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('复选框')
        self.show()

    def on_check_state_changed(self, state):
        sender = self.sender()
        if state == 2:  # 2表示选中状态
            print(f'Selected Option: {sender.text()}')

if __name__ == '__main__':
    app = QApplication([])
    window = CheckBoxApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

在这个示例中，我们创建了三个QCheckBox，设置了它们的文本和默认选中状态。通过连接stateChanged信号到槽函数，我们可以捕获复选框的状态变化。

为单选按钮添加图标:

要为单选按钮添加图标，可以使用setIcon方法。以下是一个简单的示例：

radio_btn1.setIcon(QIcon('icon1.png'))
radio_btn2.setIcon(QIcon('icon2.png'))
radio_btn3.setIcon(QIcon('icon3.png'))
1
2
3

通过以上方式，可以根据应用的需求使用不同的图标来定制单选按钮。QRadioButton和QCheckBox是在用户界面中实现选择功能的关键控件，通过适当的使用和定制，可以满足各种交互需求。

7. QDateTimeEdit、QDateEdit、QTimeEdit - 日期和时间输入

QDateTimeEdit、QDateEdit和QTimeEdit是PyQt5中用于实现日期和时间输入的控件。以下是这些控件的功能、格式化选项以及如何实现日期和时间选择的示例。

QDateTimeEdit - 日期和时间选择

QDateTimeEdit允许用户选择日期和时间。以下是一个简单的示例：

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QDateTimeEdit

class DateTimeEditApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建QDateTimeEdit
        date_time_edit = QDateTimeEdit(self)

        # 设置日期和时间范围
        date_time_edit.setMinimumDateTime(QDateTime.currentDateTime().addDays(-365))
        date_time_edit.setMaximumDateTime(QDateTime.currentDateTime().addDays(365))

        # 设置显示格式
        date_time_edit.setDisplayFormat('yyyy-MM-dd HH:mm:ss')

        # 连接日期时间变化的信号到槽函数
        date_time_edit.dateTimeChanged.connect(self.on_date_time_changed)

        # 将QDateTimeEdit添加到布局
        layout.addWidget(date_time_edit)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('日期和时间选择')
        self.show()

    def on_date_time_changed(self, datetime):
        print(f'Selected Date and Time: {datetime.toString()}')

if __name__ == '__main__':
    app = QApplication([])
    window = DateTimeEditApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

在这个示例中，我们创建了一个QDateTimeEdit，并设置了日期和时间的范围以及显示格式。通过连接dateTimeChanged信号到槽函数，我们可以捕获日期和时间的变化。

QDateEdit - 日期选择

QDateEdit用于选择日期。以下是一个简单的示例：

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QDateEdit

class DateEditApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建QDateEdit
        date_edit = QDateEdit(self)

        # 设置日期范围
        date_edit.setMinimumDate(QDate.currentDate().addDays(-365))
        date_edit.setMaximumDate(QDate.currentDate().addDays(365))

        # 设置显示格式
        date_edit.setDisplayFormat('yyyy-MM-dd')

        # 连接日期变化的信号到槽函数
        date_edit.dateChanged.connect(self.on_date_changed)

        # 将QDateEdit添加到布局
        layout.addWidget(date_edit)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('日期选择')
        self.show()

    def on_date_changed(self, date):
        print(f'Selected Date: {date.toString()}')

if __name__ == '__main__':
    app = QApplication([])
    window = DateEditApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

在这个示例中，我们创建了一个QDateEdit，并设置了日期的范围以及显示格式。通过连接dateChanged信号到槽函数，我们可以捕获日期的变化。

QTimeEdit - 时间选择

QTimeEdit用于选择时间。以下是一个简单的示例：

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QTimeEdit

class TimeEditApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建QTimeEdit
        time_edit = QTimeEdit(self)

        # 设置时间范围
        time_edit.setMinimumTime(QTime.currentTime().addSecs(-3600))
        time_edit.setMaximumTime(QTime.currentTime().addSecs(3600))

        # 设置显示格式
        time_edit.setDisplayFormat('hh:mm:ss')

        # 连接时间变化的信号到槽函数
        time_edit.timeChanged.connect(self.on_time_changed)

        # 将QTimeEdit添加到布局
        layout.addWidget(time_edit)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('时间选择')
        self.show()

    def on_time_changed(self, time):
        print(f'Selected Time: {time.toString()}')

if __name__ == '__main__':
    app = QApplication([])
    window = TimeEditApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

在这个示例中，我们创建了一个QTimeEdit，并设置了时间的范围以及显示格式。通过连接timeChanged信号到

8. QProgressBar - 进度条展示

QProgressBar用于在PyQt5应用程序中展示任务进度。以下是关于QProgressBar的用途、自定义选项以及如何实现和更新进度条的示例。

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton, QProgressBar
from PyQt5.QtCore import QThread, pyqtSignal, QTimer

class WorkerThread(QThread):
    # 通过信号更新进度条
    progress_updated = pyqtSignal(int)

    def run(self):
        for i in range(101):
            # 模拟耗时任务
            self.msleep(50)
            # 发送进度信号
            self.progress_updated.emit(i)

class ProgressBarApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建进度条
        self.progress_bar = QProgressBar(self)
        self.progress_bar.setMinimum(0)
        self.progress_bar.setMaximum(100)

        # 创建开始任务按钮
        start_button = QPushButton('开始任务', self)
        start_button.clicked.connect(self.start_task)

        # 将进度条和按钮添加到布局
        layout.addWidget(self.progress_bar)
        layout.addWidget(start_button)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('进度条展示')
        self.show()

    def start_task(self):
        # 创建并启动工作线程
        self.worker_thread = WorkerThread(self)
        self.worker_thread.progress_updated.connect(self.update_progress)
        self.worker_thread.start()

    def update_progress(self, value):
        # 更新进度条的值
        self.progress_bar.setValue(value)

if __name__ == '__main__':
    app = QApplication([])
    window = ProgressBarApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

在这个示例中，我们创建了一个简单的PyQt5应用程序，包括一个QProgressBar和一个按钮。当用户点击按钮时，会启动一个后台工作线程（WorkerThread），该线程模拟一个耗时任务，每完成一部分任务就发射一个信号（progress_updated），通过这个信号更新主线程中的进度条。这样可以确保在执行耗时任务的同时，用户界面保持响应。

9. 控件的高级应用和集成

在PyQt5中，控件的高级应用和集成是创建复杂用户界面的关键。以下是一些高级技巧，包括信号与槽的使用，以增强控件功能。

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton, QLabel, QLineEdit
from PyQt5.QtCore import Qt

class AdvancedWidgetsApp(QWidget):
    def __init__(self):
        super().__init__()

        self.init_ui()

    def init_ui(self):
        layout = QVBoxLayout()

        # 创建标签和文本框
        label = QLabel('输入文本:', self)
        line_edit = QLineEdit(self)

        # 创建按钮，点击按钮时触发槽函数
        button = QPushButton('显示输入', self)
        button.clicked.connect(lambda: self.show_input(line_edit.text()))

        # 将控件添加到布局
        layout.addWidget(label)
        layout.addWidget(line_edit)
        layout.addWidget(button)

        # 设置布局
        self.setLayout(layout)

        self.setWindowTitle('控件高级应用')
        self.show()

    def show_input(self, text):
        # 创建一个新窗口显示输入文本
        popup = QWidget(self, flags=Qt.Popup)
        popup.setGeometry(300, 300, 200, 100)

        popup_layout = QVBoxLayout(popup)
        popup_label = QLabel(f'你输入的文本是: {text}', popup)

        popup_layout.addWidget(popup_label)

        popup.show()

if __name__ == '__main__':
    app = QApplication([])
    window = AdvancedWidgetsApp()
    app.exec_()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

在这个示例中，我们创建了一个带有标签、文本框和按钮的窗口。当用户在文本框中输入文本并点击按钮时，会弹出一个新窗口，显示用户输入的文本。这个示例演示了如何集成不同的控件，并使用信号与槽机制实现交互。这样的高级应用和集成使得可以创建更加灵活和交互性强的用户界面。

10. 最佳实践和常见问题

在使用输入和控制控件时，以下是一些建议的最佳实践和一些常见问题的解决方案：

最佳实践：

1. 清晰的标签和提示信息： 为输入控件添加清晰的标签和提示信息，以帮助用户理解输入的预期内容。

2. 输入验证和反馈： 在可能的情况下，进行输入验证，并提供及时的反馈。这可以通过颜色、图标或弹出消息来实现。

3. 合理的默认值： 对于输入控件，如果可能，设置合理的默认值，以减少用户的输入工作量。

4. 利用信号与槽： 使用PyQt5的信号与槽机制，实现控件之间的交互，提高用户体验。

5. 测试不同分辨率： 在设计界面时，考虑不同屏幕分辨率，以确保界面在不同设备上都能正常显示。

常见问题及解决方案：

1. 文本过长截断： 当显示文本的控件空间有限时，文本可能被截断。解决方案是使用工具提示或滚动条，以便用户可以查看完整的文本。

2. 输入超出范围： 对于数字输入控件，用户可能输入超出范围的值。添加输入验证和范围限制可以解决这个问题。

3. 复选框和单选按钮排列： 当有多个复选框或单选按钮时，良好的排列方式有助于用户理解选项。可以使用布局管理器来实现良好的排列。

4. 界面冗余： 避免在界面中添加过多控件和信息，以免让用户感到混乱。优化界面布局，突出重要信息。

5. 不同平台的外观差异： 不同操作系统可能对控件的外观有不同的默认风格。通过使用样式表（Stylesheet）可以调整控件的外观，使其在不同平台上更一致。

通过遵循这些最佳实践和解决常见问题的方法，可以提高应用程序的用户友好性和可用性。

11. 结论

通过本文的探讨，我们深入了解了在PyQt5应用程序中使用的各种输入和控制控件。这些控件不仅提供了用户与应用程序交互的手段，还能够增强用户体验并简化数据输入和展示的过程。

从基础的文本输入控件到数字输入、下拉选择列表、日期时间选择等高级控件，每个控件都有其特定的用途和功能。通过合理的设计和配置，我们能够创建直观、易用的用户界面，提高应用程序的可用性。

在使用这些控件时，我们学习了一些最佳实践，例如清晰的标签和提示信息、输入验证和反馈、合理的默认值等，以及解决一些常见问题的方法。这些实践有助于确保用户能够方便而愉快地与应用程序进行交互。

在设计界面时，考虑到不同屏幕分辨率和平台的外观差异也是至关重要的，这有助于确保应用程序在各种环境下都能够正常运行和显示。

总体而言，深入理解输入和控制控件是创建功能丰富、用户友好的界面的关键一步。通过巧妙地组合这些控件，并结合PyQt5强大的功能，开发者能够打造出专业、高效的PyQt5应用程序。在未来的开发中，持续学习和掌握这些知识，将会是提高开发效率和用户满意度的重要因素。