前言

建議把代碼復(fù)制到pycharm等IDE上面看實(shí)際效果，方便理解嗷??

序篇：1-3部分：PyQt5基礎(chǔ)與常用控件

第1部分：初識(shí) PyQt5 和安裝

1.1 什么是 PyQt5？

PyQt5 是 Python 的圖形用戶界面 (GUI) 框架，它基于強(qiáng)大的 Qt 庫。Qt 是一個(gè)跨平臺(tái)的 C++ 框架，用于構(gòu)建桌面應(yīng)用程序。通過 PyQt5，我們可以用 Python 輕松構(gòu)建跨平臺(tái)的桌面應(yīng)用程序，支持 Windows、macOS 和 Linux。

1.2 在 PyCharm 中安裝 PyQt5

• 打開 PyCharm： 打開你的 PyCharm 編輯器，確保你已經(jīng)有一個(gè)項(xiàng)目或新建一個(gè)項(xiàng)目。

• 安裝 PyQt5： 你可以在 PyCharm 中使用兩種方式安裝 PyQt5：

  • 方法 1：通過 PyCharm 的設(shè)置安裝

    • 點(diǎn)擊 File -> Settings。
    • 在設(shè)置界面中，選擇 Project -> Python Interpreter。
    • 點(diǎn)擊右側(cè)的 + 按鈕，搜索 PyQt5。
    • 選擇 PyQt5 并點(diǎn)擊 Install Package 安裝。

  • 方法 2：通過 PyCharm 終端安裝

    • 打開 Terminal 窗口（在 PyCharm 底部菜單欄中找到“Terminal”選項(xiàng)）。

    • 輸入以下命令安裝 PyQt5：

      pip install PyQt5
      

    • 安裝完成后，PyCharm 會(huì)自動(dòng)識(shí)別并添加 PyQt5 到項(xiàng)目中。

• 檢查安裝是否成功： 你可以通過在終端中運(yùn)行 pip list 查看是否安裝了 PyQt5。

1.3 在 PyCharm 中編寫第一個(gè) PyQt5 應(yīng)用程序

接下來，我們將在 PyCharm 中創(chuàng)建一個(gè)簡單的 PyQt5 應(yīng)用程序，顯示一個(gè)包含 “Hello, World!” 的窗口。

• 創(chuàng)建 Python 文件：
  • 在 PyCharm 項(xiàng)目中，右鍵點(diǎn)擊項(xiàng)目文件夾，選擇 New -> Python File，將文件命名為 main.py。
• 編寫代碼： 在新建的 main.py 文件中，輸入以下代碼：

import sys  # 導(dǎo)入 sys 模塊，用于與 Python 解釋器交互
from PyQt5.QtWidgets import QApplication, QLabel, QMainWindow  # 從 PyQt5 中導(dǎo)入所需的類

# 創(chuàng)建一個(gè)主窗口類，繼承自 QMainWindow
class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()  # 調(diào)用父類 QMainWindow 的初始化方法
        self.setWindowTitle("PyQt5 第一個(gè)窗口")  # 設(shè)置窗口標(biāo)題

        # 創(chuàng)建一個(gè) QLabel 標(biāo)簽，并將其作為主窗口的中央控件
        label = QLabel("Hello, World!", self)
        self.setCentralWidget(label)  # 將標(biāo)簽作為窗口的中央控件

# 創(chuàng)建一個(gè) PyQt5 應(yīng)用程序?qū)ο?
app = QApplication(sys.argv)

# 創(chuàng)建主窗口實(shí)例
window = MainWindow()
window.show()  # 顯示窗口

# 進(jìn)入應(yīng)用程序的事件循環(huán)，保持應(yīng)用程序運(yùn)行，直到關(guān)閉窗口
sys.exit(app.exec_())

1.4 代碼詳細(xì)解釋

• import sys
  • 作用：sys 是 Python 的內(nèi)置模塊，提供了一些與 Python 解釋器進(jìn)行交互的功能。在 PyQt5 中，sys.exit() 用來確保應(yīng)用程序關(guān)閉時(shí)退出干凈，不留任何后臺(tái)進(jìn)程。
• from PyQt5.QtWidgets import QApplication, QLabel, QMainWindow
  • QApplication：每個(gè) PyQt5 程序必須有一個(gè) QApplication 實(shí)例，它管理應(yīng)用程序的控制流和設(shè)置。
  • QMainWindow：這是 PyQt5 中的主窗口類，它是所有復(fù)雜窗口的基礎(chǔ)。可以包含菜單欄、工具欄、狀態(tài)欄、中央控件等。
  • QLabel：這是一個(gè)簡單的控件，用于顯示文本。
• class MainWindow(QMainWindow):
  • 作用：定義了一個(gè)名為 MainWindow 的類，繼承自 QMainWindow。通過繼承 QMainWindow，我們可以自定義窗口的行為和外觀。
• self.setWindowTitle("PyQt5 第一個(gè)窗口")
  • 作用：設(shè)置窗口的標(biāo)題，標(biāo)題顯示在應(yīng)用程序窗口的頂部。
• label = QLabel("Hello, World!", self)
  • 作用：創(chuàng)建一個(gè) QLabel 控件，顯示文本 “Hello, World!”。
  • self 參數(shù)：將標(biāo)簽關(guān)聯(lián)到當(dāng)前窗口（MainWindow），即將其設(shè)置為窗口的子控件。
• self.setCentralWidget(label)
  • 作用：設(shè)置 label 為窗口的中央控件，中央控件是填充窗口中間區(qū)域的控件。
• app = QApplication(sys.argv)
  • 作用：QApplication 是 PyQt5 應(yīng)用程序的基礎(chǔ)，每個(gè) PyQt5 應(yīng)用程序都必須有一個(gè) QApplication 實(shí)例，它管理整個(gè)應(yīng)用程序的生命周期和事件處理。
  • sys.argv：傳遞命令行參數(shù)，通?？梢院雎浴?/li>
• window.show()
  • 作用：將窗口設(shè)置為可見，并顯示在屏幕上。
• sys.exit(app.exec_())
  • 作用：app.exec_() 開始應(yīng)用程序的事件循環(huán)，保持應(yīng)用程序的持續(xù)運(yùn)行，直到用戶關(guān)閉窗口。sys.exit() 確保應(yīng)用程序正常退出。

1.5 在 PyCharm 中運(yùn)行程序

• 確保你的 PyQt5 安裝正確，并且代碼已經(jīng)保存。
• 點(diǎn)擊 PyCharm 界面頂部的綠色 Run 按鈕，或者右鍵點(diǎn)擊代碼文件并選擇 Run ‘main’。

運(yùn)行代碼后，你將看到一個(gè)包含 “Hello, World!” 的窗口彈出。

1.6 常見問題排查

• 沒有安裝 PyQt5：確保你已經(jīng)在項(xiàng)目的解釋器中正確安裝了 PyQt5，可以通過 pip list 命令檢查是否安裝。
• 解釋器配置錯(cuò)誤：確保 PyCharm 中使用的 Python 解釋器與安裝了 PyQt5 的 Python 版本一致。
• 窗口不顯示：檢查代碼中是否調(diào)用了 window.show()，沒有調(diào)用該方法窗口將不會(huì)顯示。

1.7 總結(jié)

• PyQt5 是一個(gè)非常強(qiáng)大的 GUI 框架，適合用于創(chuàng)建桌面應(yīng)用程序。
• 我們通過簡單的幾行代碼，創(chuàng)建了一個(gè)帶有文本標(biāo)簽的基本窗口。
• 你可以通過 PyCharm 輕松運(yùn)行 PyQt5 程序，并使用其強(qiáng)大的功能來構(gòu)建復(fù)雜的用戶界面。

第2部分：創(chuàng)建 PyQt5 應(yīng)用程序與布局管理

2.1 PyQt5 的基本窗口結(jié)構(gòu)

在 PyQt5 中，窗口（window）是應(yīng)用程序的核心部分。我們已經(jīng)了解了如何創(chuàng)建一個(gè)簡單的 QMainWindow，并在其中顯示一些基本內(nèi)容，比如文本標(biāo)簽 (QLabel)?，F(xiàn)在，我們將進(jìn)一步了解 PyQt5 中的 布局管理，并學(xué)習(xí)如何合理地組織多個(gè)控件，使界面更具交互性和美觀性。

2.2 基本的 PyQt5 窗口與布局

QWidget 與 QMainWindow 的區(qū)別

• QWidget：是 PyQt5 中的所有控件（如按鈕、標(biāo)簽、文本框等）的基類。任何可視化控件基本上都可以繼承自 QWidget。它也是最基礎(chǔ)的窗口控件，可以用來創(chuàng)建簡單的窗口。
• QMainWindow：是一個(gè)高級(jí)窗口控件，繼承自 QWidget，但是它具有更多的功能，比如菜單欄、工具欄、狀態(tài)欄等。你可以把 QMainWindow 理解為一個(gè)“帶更多功能的高級(jí)窗口”。

2.3 布局管理器

在開發(fā) GUI 應(yīng)用程序時(shí)，如何排列和管理窗口中的控件至關(guān)重要。PyQt5 提供了幾個(gè)常用的布局管理器，讓控件自動(dòng)調(diào)整位置和大小。常見的布局管理器有：

• QVBoxLayout：垂直布局管理器，控件從上到下排列。
• QHBoxLayout：水平布局管理器，控件從左到右排列。
• QGridLayout：網(wǎng)格布局管理器，控件按網(wǎng)格排列。
• QFormLayout：表單布局管理器，適合排列標(biāo)簽和輸入框。

2.4 在窗口中使用布局管理器

我們來創(chuàng)建一個(gè)包含多個(gè)控件的窗口，使用 QVBoxLayout 和 QHBoxLayout 來組織這些控件。

完整代碼：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout, QHBoxLayout, QPushButton, QLabel

# 創(chuàng)建一個(gè)主窗口類，繼承自 QMainWindow
class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("PyQt5 布局示例")  # 設(shè)置窗口標(biāo)題

        # 創(chuàng)建主窗口中的中央控件，QMainWindow 需要設(shè)置中央控件
        central_widget = QWidget(self)
        self.setCentralWidget(central_widget)

        # 創(chuàng)建垂直布局管理器
        vbox_layout = QVBoxLayout()

        # 創(chuàng)建標(biāo)簽控件并添加到布局中
        label = QLabel("這是一個(gè)標(biāo)簽")
        vbox_layout.addWidget(label)

        # 創(chuàng)建水平布局管理器
        hbox_layout = QHBoxLayout()

        # 創(chuàng)建兩個(gè)按鈕，并添加到水平布局中
        button1 = QPushButton("按鈕 1")
        button2 = QPushButton("按鈕 2")
        hbox_layout.addWidget(button1)
        hbox_layout.addWidget(button2)

        # 將水平布局添加到垂直布局中
        vbox_layout.addLayout(hbox_layout)

        # 將布局設(shè)置為中央控件的布局
        central_widget.setLayout(vbox_layout)

# 創(chuàng)建應(yīng)用程序?qū)ο?
app = QApplication(sys.argv)

# 創(chuàng)建主窗口
window = MainWindow()
window.show()

# 進(jìn)入應(yīng)用程序的事件循環(huán)
sys.exit(app.exec_())

2.5 代碼詳解

• QWidget 與 QMainWindow：
  • 我們使用了 QMainWindow 作為主窗口，主窗口需要設(shè)置一個(gè)中央控件，所以我們創(chuàng)建了一個(gè) QWidget 實(shí)例 central_widget。
  • setCentralWidget() 方法用于將 QWidget 設(shè)置為 QMainWindow 的中央控件，這個(gè)中央控件是放置所有其他控件的容器。
• 布局管理器：QVBoxLayout 與 QHBoxLayout：
  • QVBoxLayout 是一個(gè)垂直布局管理器，控件會(huì)從上到下排列。
  • QHBoxLayout 是一個(gè)水平布局管理器，控件會(huì)從左到右排列。
  • 我們先在窗口中添加了一個(gè)標(biāo)簽，然后再添加了兩個(gè)水平排列的按鈕。按鈕排列在水平布局中，水平布局本身又嵌入到了垂直布局中，形成了一種靈活的組合布局。
• 添加控件到布局：
  • vbox_layout.addWidget(label) 將標(biāo)簽控件添加到垂直布局中。
  • hbox_layout.addWidget(button1) 和 hbox_layout.addWidget(button2) 將按鈕控件添加到水平布局中。
• 布局嵌套：
  • 通過 vbox_layout.addLayout(hbox_layout)，我們將水平布局嵌入到垂直布局中，實(shí)現(xiàn)更復(fù)雜的布局結(jié)構(gòu)。

    

2.6 更多布局管理器介紹

QGridLayout (網(wǎng)格布局管理器)

QGridLayout 允許你以網(wǎng)格的形式排列控件，每個(gè)控件可以放置在指定的行和列中。它適合用來創(chuàng)建表單或矩陣式的控件布局。

QGridLayout 示例：

from PyQt5.QtWidgets import QApplication, QWidget, QGridLayout, QLabel, QPushButton
import sys

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

        self.setWindowTitle("QGridLayout 示例")
        
        # 創(chuàng)建一個(gè)網(wǎng)格布局
        layout = QGridLayout()

        # 添加控件到網(wǎng)格布局的特定行和列
        layout.addWidget(QLabel("標(biāo)簽 1"), 0, 0)  # 在第 0 行，第 0 列添加標(biāo)簽
        layout.addWidget(QPushButton("按鈕 1"), 0, 1)  # 在第 0 行，第 1 列添加按鈕
        layout.addWidget(QLabel("標(biāo)簽 2"), 1, 0)  # 在第 1 行，第 0 列添加標(biāo)簽
        layout.addWidget(QPushButton("按鈕 2"), 1, 1)  # 在第 1 行，第 1 列添加按鈕

        # 將布局設(shè)置為窗口的布局
        self.setLayout(layout)

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代碼詳解：

• QGridLayout()：創(chuàng)建了一個(gè)網(wǎng)格布局對象。
• addWidget(widget, row, column)：將控件添加到指定的行和列中，比如 (0, 0) 表示控件放置在第一行第一列。

  

2.7 總結(jié)

在這一部分中，我們學(xué)習(xí)了如何在 PyQt5 中使用布局管理器來組織窗口內(nèi)的控件。我們主要介紹了幾種常見的布局方式：

• QVBoxLayout：垂直排列控件。
• QHBoxLayout：水平排列控件。
• QGridLayout：網(wǎng)格方式排列控件。

通過使用這些布局管理器，我們可以讓窗口中的控件自動(dòng)調(diào)整位置和大小，而不需要手動(dòng)計(jì)算控件的坐標(biāo)。

這部分在之后還會(huì)有更加詳細(xì)的介紹

第3部分：常用控件詳解

在 PyQt5 中，常用的控件（也稱為小部件）有很多，它們可以用來實(shí)現(xiàn)用戶界面中的各種元素，比如按鈕、文本框、復(fù)選框等。接下來，我們將逐一介紹，并展示如何使用這些控件。

3.1 QLabel（標(biāo)簽）

QLabel 是一個(gè)用于顯示文本或圖片的控件。它是最簡單的控件之一，常用于顯示靜態(tài)文本。

代碼示例：

from PyQt5.QtWidgets import QApplication, QLabel, QMainWindow
from PyQt5.QtCore import Qt  # 導(dǎo)入 Qt 模塊
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QLabel 示例")

        # 創(chuàng)建標(biāo)簽并設(shè)置文本
        label = QLabel("這是一個(gè)標(biāo)簽", self)

        # 設(shè)置標(biāo)簽的對齊方式
        label.setAlignment(Qt.AlignCenter)

        # 設(shè)置標(biāo)簽為中央控件
        self.setCentralWidget(label)

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代碼詳解：

• QLabel：用于顯示文本的控件。你可以設(shè)置標(biāo)簽的內(nèi)容、字體、對齊方式等。
• setAlignment(Qt.AlignCenter)：將標(biāo)簽的文本設(shè)置為居中對齊。
• self.setCentralWidget(label)：將標(biāo)簽設(shè)置為窗口的中央控件。

3.2 QPushButton（按鈕）

QPushButton 是一個(gè)按鈕控件，用戶可以點(diǎn)擊按鈕來觸發(fā)事件。它是最常見的控件之一。

代碼示例：

from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QPushButton 示例")

        # 創(chuàng)建按鈕
        button = QPushButton("點(diǎn)擊我", self)

        # 設(shè)置按鈕點(diǎn)擊事件
        button.clicked.connect(self.button_clicked)

        # 將按鈕設(shè)置為窗口的中央控件
        self.setCentralWidget(button)

    # 定義按鈕點(diǎn)擊時(shí)觸發(fā)的事件
    def button_clicked(self):
        print("按鈕被點(diǎn)擊！")

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代碼詳解：

• QPushButton：創(chuàng)建了一個(gè)按鈕控件，顯示文本為“點(diǎn)擊我”。
• button.clicked.connect(self.button_clicked)：連接按鈕的點(diǎn)擊信號(hào)到自定義的 button_clicked 方法。當(dāng)按鈕被點(diǎn)擊時(shí)，這個(gè)方法會(huì)被觸發(fā)。
• self.button_clicked：定義了一個(gè)槽函數(shù)，用于響應(yīng)按鈕點(diǎn)擊事件。在槽函數(shù)中，程序會(huì)打印 “按鈕被點(diǎn)擊！”。

  

3.3 QLineEdit（單行文本框）

QLineEdit 是一個(gè)單行文本框，用于讓用戶輸入文本。你可以獲取用戶輸入的文本并對其進(jìn)行處理。

代碼示例：

from PyQt5.QtWidgets import QApplication, QMainWindow, QLineEdit
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QLineEdit 示例")

        # 創(chuàng)建文本框
        self.line_edit = QLineEdit(self)

        # 設(shè)置默認(rèn)提示文本
        self.line_edit.setPlaceholderText("請輸入文本")

        # 將文本框設(shè)置為中央控件
        self.setCentralWidget(self.line_edit)

        # 連接文本輸入結(jié)束的信號(hào)到槽函數(shù)
        self.line_edit.returnPressed.connect(self.return_pressed)

    def return_pressed(self):
        # 獲取用戶輸入的文本
        text = self.line_edit.text()
        print(f"用戶輸入: {text}")

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代碼詳解：

• QLineEdit：創(chuàng)建了一個(gè)單行文本框控件，允許用戶輸入文本。
• setPlaceholderText()：設(shè)置占位符文本，當(dāng)用戶沒有輸入時(shí)顯示提示文本。
• self.line_edit.returnPressed.connect(self.return_pressed)：連接用戶按下“回車鍵”時(shí)的信號(hào)到 return_pressed 槽函數(shù)，獲取輸入文本并打印出來。

  

3.4 QCheckBox（復(fù)選框）

QCheckBox 是一個(gè)復(fù)選框，用戶可以選擇或取消選擇該選項(xiàng)。它通常用于讓用戶勾選某些偏好或選項(xiàng)。

代碼示例：

from PyQt5.QtWidgets import QApplication, QMainWindow, QCheckBox
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QCheckBox 示例")

        # 創(chuàng)建復(fù)選框
        self.checkbox = QCheckBox("同意條款", self)

        # 設(shè)置復(fù)選框狀態(tài)改變事件
        self.checkbox.stateChanged.connect(self.checkbox_changed)

        # 將復(fù)選框設(shè)置為中央控件
        self.setCentralWidget(self.checkbox)

    def checkbox_changed(self, state):
        if state == Qt.Checked:
            print("復(fù)選框被勾選")
        else:
            print("復(fù)選框未被勾選")

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代碼詳解：

• QCheckBox：創(chuàng)建一個(gè)復(fù)選框，顯示文本為“同意條款”。
• self.checkbox.stateChanged.connect(self.checkbox_changed)：連接復(fù)選框狀態(tài)改變的信號(hào)到槽函數(shù) checkbox_changed，當(dāng)用戶勾選或取消勾選時(shí)會(huì)觸發(fā)相應(yīng)的事件。
• checkbox_changed(self, state)：根據(jù)復(fù)選框的狀態(tài)（勾選或未勾選）打印相應(yīng)的消息。

3.5 QComboBox（下拉列表）

QComboBox 是一個(gè)下拉列表控件，用戶可以從中選擇一個(gè)選項(xiàng)。

代碼示例：

from PyQt5.QtWidgets import QApplication, QMainWindow, QComboBox
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QComboBox 示例")

        # 創(chuàng)建下拉列表
        self.combobox = QComboBox(self)

        # 添加選項(xiàng)
        self.combobox.addItems(["選項(xiàng) 1", "選項(xiàng) 2", "選項(xiàng) 3"])

        # 連接下拉列表選項(xiàng)改變事件
        self.combobox.currentIndexChanged.connect(self.combobox_changed)

        # 將下拉列表設(shè)置為中央控件
        self.setCentralWidget(self.combobox)

    def combobox_changed(self, index):
        # 獲取當(dāng)前選中的文本
        text = self.combobox.currentText()
        print(f"當(dāng)前選中: {text}")

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代碼詳解：

• QComboBox：創(chuàng)建一個(gè)下拉列表控件，用戶可以從中選擇選項(xiàng)。
• self.combobox.addItems()：向下拉列表中添加選項(xiàng)。
• currentIndexChanged.connect()：連接下拉列表選項(xiàng)改變的信號(hào)到 combobox_changed 槽函數(shù)，當(dāng)用戶選擇不同的選項(xiàng)時(shí)會(huì)打印選中的文本。

  

3.6 總結(jié)

在這一部分中，我們介紹了 PyQt5 中一些常見的控件，分別是：

• QLabel：顯示靜態(tài)文本或圖片。
• QPushButton：創(chuàng)建按鈕，用戶點(diǎn)擊觸發(fā)事件。
• QLineEdit：單行文本框，用戶可以輸入文本。
• QCheckBox：復(fù)選框，用戶可以選擇或取消選擇。
• QComboBox：下拉列表，用戶可以選擇一個(gè)選項(xiàng)。

這些控件是 GUI 應(yīng)用程序的基礎(chǔ)組成部分，它們讓應(yīng)用程序更加互動(dòng)和可操作。

1-3部分總結(jié)

第1至第3部分中，我們介紹了 PyQt5 的基礎(chǔ)知識(shí)和一些常用的控件。首先，我們講解了如何安裝 PyQt5，并創(chuàng)建了一個(gè)簡單的 PyQt5 應(yīng)用程序。接著，介紹了布局管理器（如 QVBoxLayout 和 QHBoxLayout），并通過它們組織界面中的控件。最后，我們深入探討了 PyQt5 中的常用控件，如 QLabel、QPushButton、QLineEdit 和 QCheckBox，展示了如何使用這些控件處理基本的用戶交互。

到此這篇關(guān)于PyQt5超詳細(xì)入門級(jí)教程的文章就介紹到這了,更多相關(guān)PyQt5入門到精通內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論