PyQt 主要類

---

---

PyQt 模組

PyQt API 包含大量的類和方法。這些類定義在 20 多個模組中。以下是常用的一些模組：

PyQt 中的類

PyQt API 包含 400 多個類。QObject 類位於類層次結構的頂層。它是所有 Qt 物件的基類。此外，QPaintDevice 類是所有可繪製物件的基類。

QApplication 類管理 GUI 應用程式的主要設定和控制流程。它包含主事件迴圈，在該迴圈中處理和分派由視窗元素和其他來源生成的事件。它還處理系統範圍和應用程式範圍的設定。

QWidget 類繼承自 QObject 和 QPaintDevice 類，是所有使用者介面物件的基類。QDialog 和 QFrame 類也繼承自 QWidget 類。它們有自己的子類系統。

下圖顯示了一些重要類及其繼承關係。

這裡列出了一些常用的控制元件：

以下是常用的控制元件。

一個典型的基於 GUI 的應用程式的頂級視窗是由QMainWindow 控制元件物件建立的。上面列出的一些控制元件在其指定位置佔據主視窗，而其他控制元件則使用各種佈局管理器放置在中央控制元件區域。

下圖顯示了 QMainWindow 框架：

PyQt 中一些主要類的示例

1. QMainWindow：GUI 應用程式的基礎

QMainWindow 代表主應用程式視窗，提供一個集中的中心來組織控制元件、選單、工具欄等等。透過繼承 QMainWindow，開發人員可以快速建立健壯的應用程式框架，而無需編寫大量的樣板程式碼。

from PyQt6.QtWidgets import QMainWindow, QApplication
import sys
class MainWindow(QMainWindow):
   def __init__(self):
      super().__init__()
      self.initUI()

   def initUI(self):
      # Initialize and configure UI elements
      self.setWindowTitle("PyQt Major Classes Demo")

if __name__ == "__main__":
   app = QApplication(sys.argv)
   window = MainWindow()
   window.show()
   sys.exit(app.exec())

輸出

2. QWidget：使用者介面的構建塊

在 PyQt 中，QWidget 用作構建使用者介面的基本構建塊。從按鈕到文字輸入，螢幕上的每個可見元素最終都源自 QWidget 類。

from PyQt6.QtWidgets import QMainWindow, QApplication, QWidget
import sys
class CustomWidget(QWidget):
   def __init__(self):
      super().__init__()
      self.initUI()

   def initUI(self):
      # Initialize and configure custom UI elements
      self.setWindowTitle("PyQt Qwidget class")

if __name__ == "__main__":
   app = QApplication(sys.argv)
   window = CustomWidget()
   window.show()
   sys.exit(app.exec())

輸出

3. QLabel、QPushButton 及其他：專用控制元件

除了 QMainWindow 和 QWidget 等核心類之外，PyQt 還提供了許多專門的控制元件，以滿足不同的使用場景。QLabel 用於顯示文字和影像，QPushButton 用於建立互動式按鈕，而 QComboBox 和 QCheckBox 簡化了使用者輸入和選擇。

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

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

   def initUI(self):
      self.setWindowTitle("PyQt Major Classes Demo")

      # Create QLabel
      label = QLabel("Hello, PyQt!")

      # Create QPushButton
      button = QPushButton("Click Me")
      button.clicked.connect(self.onButtonClick)

      # Create a vertical layout
      layout = QVBoxLayout()
      layout.addWidget(label)
      layout.addWidget(button)

      # Create a central widget and set the layout
      central_widget = QWidget()
      central_widget.setLayout(layout)
      self.setCentralWidget(central_widget)

   def onButtonClick(self):
      print("Button clicked!")

if __name__ == "__main__":
   app = QApplication(sys.argv)
   window = MainWindow()
   window.show()
   sys.exit(app.exec())

輸出