PyQt5 超詳細入門級教程

前言

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

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

第1部分：初識 PyQt5 和安裝

1.1 什么是 PyQt5？

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

1.2 在 PyCharm 中安裝 PyQt5

• 打開 PyCharm： 打開你的 PyCharm 編輯器，確保你已經(jīng)有一個項目或新建一個項目。
• 安裝 PyQt5： 你可以在 PyCharm 中使用兩種方式安裝 PyQt5：
• 方法 1：通過 PyCharm 的設(shè)置安裝
  • 點擊 File -> Settings。
  • 在設(shè)置界面中，選擇 Project -> Python Interpreter。
  • 點擊右側(cè)的 + 按鈕，搜索 PyQt5。
  • 選擇 PyQt5 并點擊 Install Package 安裝。
• 方法 2：通過 PyCharm 終端安裝
  • 打開 Terminal 窗口（在 PyCharm 底部菜單欄中找到“Terminal”選項）。
  • 輸入以下命令安裝 PyQt5：

• pip install PyQt5

• 安裝完成后，PyCharm 會自動識別并添加 PyQt5 到項目中。
• 檢查安裝是否成功： 你可以通過在終端中運行 pip list 查看是否安裝了 PyQt5。

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

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

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

import sys  # 導(dǎo)入 sys 模塊，用于與 Python 解釋器交互
from PyQt5.QtWidgets import QApplication, QLabel, QMainWindow  # 從 PyQt5 中導(dǎo)入所需的類
# 創(chuàng)建一個主窗口類，繼承自 QMainWindow
class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()  # 調(diào)用父類 QMainWindow 的初始化方法
        self.setWindowTitle("PyQt5 第一個窗口")  # 設(shè)置窗口標題
        # 創(chuàng)建一個 QLabel 標簽，并將其作為主窗口的中央控件
        label = QLabel("Hello, World!", self)
        self.setCentralWidget(label)  # 將標簽作為窗口的中央控件
# 創(chuàng)建一個 PyQt5 應(yīng)用程序?qū)ο?
app = QApplication(sys.argv)
# 創(chuàng)建主窗口實例
window = MainWindow()
window.show()  # 顯示窗口
# 進入應(yīng)用程序的事件循環(huán)，保持應(yīng)用程序運行，直到關(guān)閉窗口
sys.exit(app.exec_())

1.4 代碼詳細解釋

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

1.5 在 PyCharm 中運行程序

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

運行代碼后，你將看到一個包含 “Hello, World!” 的窗口彈出。

1.6 常見問題排查

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

1.7 總結(jié)

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

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

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

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

2.2 基本的 PyQt5 窗口與布局

QWidget 與 QMainWindow 的區(qū)別

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

2.3 布局管理器

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

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

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

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

完整代碼：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout, QHBoxLayout, QPushButton, QLabel
# 創(chuàng)建一個主窗口類，繼承自 QMainWindow
class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("PyQt5 布局示例")  # 設(shè)置窗口標題
        # 創(chuàng)建主窗口中的中央控件，QMainWindow 需要設(shè)置中央控件
        central_widget = QWidget(self)
        self.setCentralWidget(central_widget)
        # 創(chuàng)建垂直布局管理器
        vbox_layout = QVBoxLayout()
        # 創(chuàng)建標簽控件并添加到布局中
        label = QLabel("這是一個標簽")
        vbox_layout.addWidget(label)
        # 創(chuàng)建水平布局管理器
        hbox_layout = QHBoxLayout()
        # 創(chuàng)建兩個按鈕，并添加到水平布局中
        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()
# 進入應(yīng)用程序的事件循環(huán)
sys.exit(app.exec_())

2.5 代碼詳解

1. QWidget 與 QMainWindow：
   • 我們使用了 QMainWindow 作為主窗口，主窗口需要設(shè)置一個中央控件，所以我們創(chuàng)建了一個 QWidget 實例 central_widget。
   • setCentralWidget() 方法用于將 QWidget 設(shè)置為 QMainWindow 的中央控件，這個中央控件是放置所有其他控件的容器。
2. 布局管理器：QVBoxLayout 與 QHBoxLayout：
   • QVBoxLayout 是一個垂直布局管理器，控件會從上到下排列。
   • QHBoxLayout 是一個水平布局管理器，控件會從左到右排列。
   • 我們先在窗口中添加了一個標簽，然后再添加了兩個水平排列的按鈕。按鈕排列在水平布局中，水平布局本身又嵌入到了垂直布局中，形成了一種靈活的組合布局。
3. 添加控件到布局：
   • vbox_layout.addWidget(label) 將標簽控件添加到垂直布局中。
   • hbox_layout.addWidget(button1) 和 hbox_layout.addWidget(button2) 將按鈕控件添加到水平布局中。
4. 布局嵌套：

通過 vbox_layout.addLayout(hbox_layout)，我們將水平布局嵌入到垂直布局中，實現(xiàn)更復(fù)雜的布局結(jié)構(gòu)。

2.6 更多布局管理器介紹

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

QGridLayout 允許你以網(wǎng)格的形式排列控件，每個控件可以放置在指定的行和列中。它適合用來創(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)建一個網(wǎng)格布局
        layout = QGridLayout()
        # 添加控件到網(wǎng)格布局的特定行和列
        layout.addWidget(QLabel("標簽 1"), 0, 0)  # 在第 0 行，第 0 列添加標簽
        layout.addWidget(QPushButton("按鈕 1"), 0, 1)  # 在第 0 行，第 1 列添加按鈕
        layout.addWidget(QLabel("標簽 2"), 1, 0)  # 在第 1 行，第 0 列添加標簽
        layout.addWidget(QPushButton("按鈕 2"), 1, 1)  # 在第 1 行，第 1 列添加按鈕
        # 將布局設(shè)置為窗口的布局
        self.setLayout(layout)
app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代碼詳解：

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

   

2.7 總結(jié)

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

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

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

這部分在之后還會有更加詳細的介紹

第3部分：常用控件詳解

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

3.1 QLabel（標簽）

QLabel 是一個用于顯示文本或圖片的控件。它是最簡單的控件之一，常用于顯示靜態(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)建標簽并設(shè)置文本
        label = QLabel("這是一個標簽", self)
        # 設(shè)置標簽的對齊方式
        label.setAlignment(Qt.AlignCenter)
        # 設(shè)置標簽為中央控件
        self.setCentralWidget(label)
app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代碼詳解：

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

3.2 QPushButton（按鈕）

QPushButton 是一個按鈕控件，用戶可以點擊按鈕來觸發(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("點擊我", self)
        # 設(shè)置按鈕點擊事件
        button.clicked.connect(self.button_clicked)
        # 將按鈕設(shè)置為窗口的中央控件
        self.setCentralWidget(button)
    # 定義按鈕點擊時觸發(fā)的事件
    def button_clicked(self):
        print("按鈕被點擊！")
app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代碼詳解：

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

3.3 QLineEdit（單行文本框）

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

代碼示例：

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è)置默認提示文本
        self.line_edit.setPlaceholderText("請輸入文本")
        # 將文本框設(shè)置為中央控件
        self.setCentralWidget(self.line_edit)
        # 連接文本輸入結(jié)束的信號到槽函數(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_())

代碼詳解：

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

3.4 QCheckBox（復(fù)選框）

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

代碼示例：

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_())

代碼詳解：

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

3.5 QComboBox（下拉列表）

QComboBox 是一個下拉列表控件，用戶可以從中選擇一個選項。

代碼示例：

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)
        # 添加選項
        self.combobox.addItems(["選項 1", "選項 2", "選項 3"])
        # 連接下拉列表選項改變事件
        self.combobox.currentIndexChanged.connect(self.combobox_changed)
        # 將下拉列表設(shè)置為中央控件
        self.setCentralWidget(self.combobox)
    def combobox_changed(self, index):
        # 獲取當前選中的文本
        text = self.combobox.currentText()
        print(f"當前選中: {text}")
app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代碼詳解：

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

3.6 總結(jié)

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

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

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

1-3部分總結(jié)

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

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

最新評論