PyQt6是Python中廣受歡迎的GUI框架之一，它提供了豐富的控件和布局方式，可以幫助開發者快速構建交互式應用程序。其中，表格視圖和表單布局是常用的兩種控件和布局方式，本文將詳細介紹它們的使用方法、自定義方法、事件處理以及可能遇到的問題。

1. 使用方法

（1）表格視圖

表格視圖（QTableView）是PyQt6中用于展示二維表格數據的控件，它可以顯示多個行和列，并支持各種格式的數據，如文本、數字、日期、圖像等。使用表格視圖可以方便地展示和編輯數據，常見的應用場景包括數據分析、報表生成、數據錄入等。

在PyQt6中創建表格視圖非常簡單，只需要創建一個QTableView對象，并將數據模型（QAbstractTableModel）設置給它即可。以下是一個簡單的示例代碼，用于展示一個3行4列的表格：

from PyQt6.QtWidgets import QApplication, QTableView, QAbstractTableModel
import sys

class MyTableModel(QAbstractTableModel):
    def rowCount(self, parent):
        return 3

    def columnCount(self, parent):
        return 4

    def data(self, index, role):
        if role == Qt.DisplayRole:
            return f'({index.row()},{index.column()})'

app = QApplication(sys.argv)
table_view = QTableView()
model = MyTableModel()
table_view.setModel(model)
table_view.show()
sys.exit(app.exec())

在上面的代碼中，我們首先定義了一個自定義的數據模型類MyTableModel，它繼承自QAbstractTableModel，并實現了rowCount、columnCount和data三個方法。其中，rowCount和columnCount方法分別返回表格的行數和列數，data方法用于獲取指定單元格的數據，我們在這個方法中返回一個文本字符串，格式為(行數,列數)。

然后，我們創建了一個QTableView對象table_view，并將數據模型model設置給它。最后，調用show方法顯示表格視圖，并通過app.exec()進入Qt事件循環，以保證程序能正常運行。

運行上面的代碼，會彈出一個包含3行4列的表格視圖，如下圖所示：

（2）表單布局

表單布局（QFormLayout）是PyQt6中用于展示表單數據的控件，它可以根據需要自動調整控件的大小和位置，并支持多種類型的控件，如標簽、文本框、下拉框、復選框等。使用表單布局可以方便地創建各種表單界面，如登錄界面、注冊界面、配置界面等。

在PyQt6中創建表單布局也非常簡單，只需要創建一個QFormLayout對象，并將需要添加的控件對象添加到它的布局中即可。以下是一個簡單的示例代碼，用于展示一個包含標簽、文本框和下拉框的表單：

from PyQt6.QtWidgets import QApplication, QFormLayout, QLineEdit, QLabel, QComboBox
import sys

app = QApplication(sys.argv)
form_layout = QFormLayout()

name_label = QLabel('姓名：')
name_edit = QLineEdit()
form_layout.addRow(name_label, name_edit)

gender_label = QLabel('性別：')
gender_combobox = QComboBox()
gender_combobox.addItems(['男', '女'])
form_layout.addRow(gender_label, gender_combobox)

form_layout.setFormAlignment(Qt.AlignCenter)
form_layout.setLabelAlignment(Qt.AlignRight)

form_layoutWidget = QWidget()
form_layoutWidget.setLayout(form_layout)
form_layoutWidget.show()
sys.exit(app.exec())

在上面的代碼中，我們創建了一個QFormLayout對象form_layout，并向它的布局中添加了一個標簽、一個文本框和一個下拉框。其中，標簽和文本框通過addRow方法添加到了同一行中，下拉框則添加到了下一行中。我們還使用了setFormAlignment方法和setLabelAlignment方法設置了表單和標簽的對齊方式，以保證界面布局的美觀。

最后，我們將表單布局添加到一個QWidget對象中，并調用show方法顯示界面。運行上面的代碼，會彈出一個包含標簽、文本框和下拉框的表單，如下圖所示：

2. 自定義方法

（1）表格視圖

在表格視圖中，我們可以通過自定義數據模型類的方法來實現各種功能。以下是一些常用的方法：

• headerData(section: int, orientation: Qt.Orientation, role: int) -> Any：用于設置表格的行頭和列頭數據。其中，section參數表示行數或列數，orientation參數表示方向（水平或垂直），role參數表示數據的角色（如顯示、編輯、字體等）。
• setData(index: QModelIndex, value: Any, role: int) -> bool：用于設置指定單元格的數據。其中，index參數表示單元格的索引，value參數表示要設置的數據，role參數表示數據的角色（如顯示、編輯、字體等）。
• flags(index: QModelIndex) -> Qt.ItemFlags：用于設置指定單元格的標志位。其中，index參數表示單元格的索引，Qt.ItemFlags表示單元格的標志位（如是否可編輯、是否可選中等）。
• rowCount(parent: QModelIndex = QModelIndex()) -> int：用于獲取表格的行數。其中，parent參數表示父節點的索引，如果是根節點則返回0。
• columnCount(parent: QModelIndex = QModelIndex()) -> int：用于獲取表格的列數。其中，parent參數表示父節點的索引，如果是根節點則返回0。
• index(row: int, column: int, parent: QModelIndex = QModelIndex()) -> QModelIndex：用于獲取指定單元格的索引。其中，row和column參數分別表示行數和列數，parent參數表示父節點的索引，如果是根節點則返回QModelIndex()。

以下是一個示例代碼，用于自定義數據模型類并實現上述方法：

from PyQt6.QtCore import Qt, QAbstractTableModel

class MyTableModel(QAbstractTableModel):
    def __init__(self, data):
        super().__init__()
        self._data = data

    def rowCount(self, parent):
        return len(self._data)

    def columnCount(self, parent):
        return len(self._data[0])

    def data(self, index, role):
        if role == Qt.DisplayRole:
            return str(self._data[index.row()][index.column()])
        return None

    def setData(self, index, value, role):
        if role == Qt.EditRole:
            self._data[index.row()][index.column()] = value
            self.dataChanged.emit(index, index, [Qt.DisplayRole])
            return True
        return False

    def flags(self, index):
        return super().flags(index) | Qt.ItemIsEditable

在上面的代碼中，我們定義了一個自定義的數據模型類MyTableModel，它繼承自QAbstractTableModel，并實現了rowCount、columnCount、data、setData和flags五個方法。其中，setData方法用于設置單元格數據，flags方法用于設置單元格標志位，以保證表格可以編輯。

（2）表單布局

在表單布局中，我們可以通過添加自定義控件來實現各種功能。以下是一些常用的方法：

• addRow(label: Union[str, QWidget], field: QWidget) -> None：用于向表單布局中添加一個標簽和一個字段組合。其中，label參數可以是文本字符串或控件對象，field參數為字段控件對象。
• setWidget(row: int, col: int, widget: QWidget) -> None：用于在指定位置設置控件。其中，row和col參數分別表示行數和列數，widget參數為控件對象。
• insertRow(row: int, label: Union[str, QWidget], field: QWidget) -> None：用于在指定行之前添加一個標簽和一個字段組合。其中，row參數表示行數，label參數可以是文本字符串或控件對象，field參數為字段控件對象。
• removeRow(row: int) -> None：用于刪除指定行的標簽和字段組合。其中，row參數表示行數。

以下是一個示例代碼，用于向表單布局中添加自定義控件：

from PyQt6.QtWidgets import QApplication, QFormLayout, QLineEdit, QLabel, QPushButton
import sys

app = QApplication(sys.argv)
form_layout = QFormLayout()

name_label = QLabel('姓名：')
name_edit = QLineEdit()
form_layout.addRow(name_label, name_edit)

button = QPushButton('確定')
form_layout.setWidget(1, QFormLayout.FieldRole, button)

form_layoutWidget = QWidget()
form_layoutWidget.setLayout(form_layout)
form_layoutWidget.show()
sys.exit(app.exec())

在上面的代碼中，我們向表單布局中添加了一個標簽和一個文本框，并在第二行的字段位置添加了一個按鈕。我們使用了setWidget方法將按鈕添加到布局中，并將它的位置設置為(1, QFormLayout.FieldRole)，表示在第二行的字段位置。

運行上面的代碼，會彈出一個包含標簽、文本框和按鈕的表單，如下圖所示：

3. 事件處理

（1） 表格視圖

在表格視圖中，我們可以通過重載事件處理方法來處理各種事件。以下是一些常用的事件處理方法：

• mousePressEvent(event: QMouseEvent) -> None：用于處理鼠標按下事件。其中，event參數為鼠標事件對象。
• mouseReleaseEvent(event: QMouseEvent) -> None：用于處理鼠標釋放事件。其中，event參數為鼠標事件對象。
• mouseDoubleClickEvent(event: QMouseEvent) -> None：用于處理鼠標雙擊事件。其中，event參數為鼠標事件對象。
• keyPressEvent(event: QKeyEvent) -> None：用于處理鍵盤按下事件。其中，event參數為鍵盤事件對象。

以下是一個示例代碼，用于處理表格視圖中的鼠標事件：

from PyQt6.QtWidgets import QApplication, QTableView, QAbstractTableModel
from PyQt6.QtCore import Qt
import sys

class MyTableModel(QAbstractTableModel):
    def rowCount(self, parent):
        return 3

    def columnCount(self, parent):
        return 4

    def data(self, index, role):
        if role == Qt.DisplayRole:
            return f'({index.row()},{index.column()})'

app = QApplication(sys.argv)
table_view = QTableView()
model = MyTableModel()
table_view.setModel(model)

def on_table_view_clicked(index):
    print(f'Clicked: ({index.row()},{index.column()})')

def on_table_view_double_clicked(index):
    print(f'Double clicked: ({index.row()},{index.column()})')

table_view.clicked.connect(on_table_view_clicked)
table_view.doubleClicked.connect(on_table_view_double_clicked)

table_view.show()
sys.exit(app.exec())

在上面的代碼中，我們定義了兩個事件處理函數on_table_view_clicked和
on_table_view_double_clicked，分別用于處理單擊和雙擊事件。我們通過clicked和doubleClicked信號將這兩個函數與表格視圖的事件綁定起來，并在事件處理函數中打印出單擊或雙擊的單元格索引。

運行上面的代碼，點擊或雙擊表格視圖中的單元格，會在控制臺輸出對應的行列索引，如下圖所示：

（2）表單布局

在表單布局中，我們可以通過重載事件處理方法來處理各種事件。以下是一些常用的事件處理方法：

• mousePressEvent(event: QMouseEvent) -> None：用于處理鼠標按下事件。其中，event參數為鼠標事件對象。
• mouseReleaseEvent(event: QMouseEvent) -> None：用于處理鼠標釋放事件。其中，event參數為鼠標事件對象。
• mouseDoubleClickEvent(event: QMouseEvent) -> None：用于處理鼠標雙擊事件。其中，event參數為鼠標事件對象。
• keyPressEvent(event: QKeyEvent) -> None：用于處理鍵盤按下事件。其中，event參數為鍵盤事件對象。

以下是一個示例代碼，用于處理表單布局中的鼠標事件：

from PyQt6.QtWidgets import QApplication, QFormLayout, QWidget, QLineEdit, QLabel
from PyQt6.QtCore import Qt
import sys

class MyFormLayout(QFormLayout):
    def __init__(self, parent=None):
        super().__init__(parent)

        name_label = QLabel('姓名：')
        self.name_edit = QLineEdit()
        self.addRow(name_label, self.name_edit)

    def mousePressEvent(self, event):
        if event.button() == Qt.MouseButton.LeftButton:
            print('Left button clicked')
        elif event.button() == Qt.MouseButton.RightButton:
            print('Right button clicked')

app = QApplication(sys.argv)
form_layout = MyFormLayout()

form_layout_widget = QWidget()
form_layout_widget.setLayout(form_layout)
form_layout_widget.show()

sys.exit(app.exec())

在上面的代碼中，我們定義了一個繼承自QFormLayout的子類MyFormLayout，并重載了mousePressEvent方法，用于處理鼠標按下事件。我們在構造函數中向表單布局中添加了一個標簽和一個文本框，并將表單布局放置在一個窗口部件中。

運行上面的代碼，點擊或右鍵點擊表單布局中的任意位置，會在控制臺輸出對應的信息，如下圖所示：

4. 總結

本文介紹了PyQt6中常用的兩種布局方式，即表格視圖和表單布局，并介紹了如何使用PyQt6中的事件處理機制處理鼠標和鍵盤事件。希望這篇文章能夠幫助你更好地理解PyQt6的布局和事件處理機制，并能夠編寫出更加靈活和強大的PyQt6程序。