一篇文章學會Python PyQt6表格視圖和表單布局的使用方法
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程序。
