前言

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

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

第1部分：初識 PyQt5 和安裝

1.1 什么是 PyQt5？

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

1.2 在 PyCharm 中安裝 PyQt5

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

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

  • 方法 1：通過 PyCharm 的設置安裝

    • 點擊 File -> Settings。
    • 在設置界面中，選擇 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 應用程序

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

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

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

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

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

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

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

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

1.4 代碼詳細解釋

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

1.5 在 PyCharm 中運行程序

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

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

1.6 常見問題排查

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

1.7 總結(jié)

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

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

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

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

2.2 基本的 PyQt5 窗口與布局

QWidget 與 QMainWindow 的區(qū)別

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

2.3 布局管理器

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

• QVBoxLayout：垂直布局管理器，控件從上到下排列。
• QHBoxLayout：水平布局管理器，控件從左到右排列。
• QGridLayout：網(wǎng)格布局管理器，控件按網(wǎng)格排列。
• 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 布局示例")  # 設置窗口標題

        # 創(chuàng)建主窗口中的中央控件，QMainWindow 需要設置中央控件
        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)

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

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

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

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

2.5 代碼詳解

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

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

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

代碼詳解：

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

  

2.7 總結(jié)

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

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

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

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

第3部分：常用控件詳解

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

3.1 QLabel（標簽）

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

代碼示例：

from PyQt5.QtWidgets import QApplication, QLabel, QMainWindow
from PyQt5.QtCore import Qt  # 導入 Qt 模塊
import sys

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

        self.setWindowTitle("QLabel 示例")

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

        # 設置標簽的對齊方式
        label.setAlignment(Qt.AlignCenter)

        # 設置標簽為中央控件
        self.setCentralWidget(label)

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

代碼詳解：

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

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)

        # 設置按鈕點擊事件
        button.clicked.connect(self.button_clicked)

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

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

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

代碼詳解：

• QPushButton：創(chuàng)建了一個按鈕控件，顯示文本為“點擊我”。
• button.clicked.connect(self.button_clicked)：連接按鈕的點擊信號到自定義的 button_clicked 方法。當按鈕被點擊時，這個方法會被觸發(fā)。
• self.button_clicked：定義了一個槽函數(shù)，用于響應按鈕點擊事件。在槽函數(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)

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

        # 將文本框設置為中央控件
        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_())

代碼詳解：

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

  

3.4 QCheckBox（復選框）

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

代碼示例：

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

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

        self.setWindowTitle("QCheckBox 示例")

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

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

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

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

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

代碼詳解：

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

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)

        # 將下拉列表設置為中央控件
        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_())

代碼詳解：

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

  

3.6 總結(jié)

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

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

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

1-3部分總結(jié)

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

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

最新評論