Qt中文手冊 之 QTableWidget
簡介:
QTableWidget是基於QTableView的一個預設的檢視模型;它用於顯示一個標準的表格。表格中每一個項通過QTableWidgetItem來實現。
標頭檔案:#include <QTableWidget>
繼承自:QTableView
成員函式:
1、QTableWidget::QTableWidget(QWidget * parent = 0)
預設建構函式
2、QTableWidget::QTableWidget(int rows,int columns, QWidget * parent = 0)
使用給定的行數rows和列數columns,構造表格
3、QTableWidget::~QTableWidget()
解構函式
4、void QTableWidget::cellActivated(int row,int column) [signal] 訊號函式
當位於第row行第column列的單元格被啟用時,觸發該訊號。如果該單元格可以編輯則不觸發。
5、void QTableWidget::cellChanged(int row,int column)[signal] 訊號函式
當位於第row行第column列的單元格中的資料發生變化時,觸發該訊號
6、void QTableWidget::cellClicked
當位於第row行第column列的單元格被點選時,觸發該訊號。
7、void QTableWidget::cellDoubleClicked(int row,int column)[signal] 訊號函式
當位於第row行第column列的單元格被雙擊時,觸發該訊號。
8、void QTableWidget::cellEntered(int row,int column)[signal] 訊號函式
當位於第row行第column列的單元格獲取滑鼠游標時,觸發該訊號。需要設定表格setMouseTracking
9、void QTableWidget::cellPressed(int row,int column)[signal] 訊號函式
當位於第row行第column列的單元格被按下時,觸發該訊號。
10、QWidget * QTableWidget::cellWidget(int row,int column) const
返回位於第row行第column列的單元格中視窗部件。
11、void QTableWidget::clear() [slot]槽函式
刪除表格中所有的項(QTableWidgetItem),但是表格還在。
12、void QTableWidget::clearContents() [slot]槽函式
刪除表格中所有的項(QTableWidgetItem),不包括表頭中的,但是表格還在
13、void QTableWidget::closePersistentEditor(QTableWidgetItem * item)
關閉指定item的可編輯狀態
14、int QTableWidget::column(constQTableWidgetItem * item) const
返回指定item在第幾列。
15、void QTableWidget::currentCellChanged(int currentRow,int currentColumn, int previousRow,int previousColumn) [signal] 訊號函式
當單元格的焦點變化時,發射該訊號。currentRow當前行currentColumn當前列;int previousRow之前的行 int previousColumn之前的列
16、int QTableWidget::currentColumn() const
返回當前單元格在第幾列
17、QTableWidgetItem * QTableWidget::currentItem() const
返回當前的單元格中的item
18、void QTableWidget::currentItemChanged(QTableWidgetItem * current,QTableWidgetItem * previous)[signal] 訊號函式
當單元格的焦點變化時,發射該訊號。current當前的項item;previous之前的項item
19、int QTableWidget::currentRow() const
返回當前單元格在第幾行。
20、void QTableWidget::dropEvent(QDropEvent * event) [virtual protected]
當向該表格中拖放時,觸發該事件
21、bool QTableWidget::dropMimeData(int row,int column, const QMimeData * data,Qt::DropAction action)[virtual protected]
如果指定的單元格能處理拖放中的資料,則返回真,否則返回假
22、void QTableWidget::editItem(QTableWidgetItem * item)
如果item能編輯,開始編輯該項。
23、QList<QTableWidgetItem *> QTableWidget::findItems(constQString & text, Qt::MatchFlags flags) const
返回匹配text的項的列表。
24、QTableWidgetItem * QTableWidget::horizontalHeaderItem(int column) const
返回第column列的表頭項,如果沒有則返回0。
25、QModelIndex QTableWidget::indexFromItem(QTableWidgetItem * item) const [protected]
返回指定item的QModelIndex(QAbstractItemModel的引索)
26、void QTableWidget::insertColumn(int column)
在第column列插入一個空列。
27、void QTableWidget::insertRow(int row)
在第row行插入一個空行。
28、QTableWidgetItem * QTableWidget::item(int row,int column) const
返回在第row行第column列的項,如果不存在返回0。
29、void QTableWidget::itemActivated(QTableWidgetItem * item)[signal] 訊號函式
項被啟用,發射訊號。
30、QTableWidgetItem * QTableWidget::itemAt(constQPoint & point) const
返回指定座標point處的項,如果該座標處沒有項則返回0。該座標相對於表格視窗。
31、QTableWidgetItem * QTableWidget::itemAt(int ax,int ay) const
同上。QPoint(x,y)
32、void QTableWidget::itemChanged(QTableWidgetItem * item)[signal] 訊號函式
當item的數值發生改變時,觸發該訊號
33、void QTableWidget::itemClicked(QTableWidgetItem * item)[signal] 訊號函式
當item被點選時,觸發該訊號
34、void QTableWidget::itemDoubleClicked(QTableWidgetItem * item)[signal] 訊號函式
當item被雙擊時,觸發該訊號
35、void QTableWidget::itemEntered(QTableWidgetItem * item)
當編輯item時(獲取滑鼠)時,觸發該訊號。需要設定表格setMouseTracking(true),預設是false
36、QTableWidgetItem * QTableWidget::itemFromIndex(constQModelIndex & index) const [protected]
返回給定index的項,QModelIndex指向資料?
37、void QTableWidget::itemPressed(QTableWidgetItem * item)[signal] 訊號函式
當item被按下時,觸發該訊號
38、const QTableWidgetItem * QTableWidget::itemPrototype() const
返回項的原型,通常用於克隆項
39、void QTableWidget::itemSelectionChanged()[signal] 訊號函式
當被選中的item發生改變時,觸發該訊號。
40、QList<QTableWidgetItem *> QTableWidget::items(constQMimeData * data) const [protected]
返回包含MIME data資料所有的項。
41、QMimeData * QTableWidget::mimeData(constQList<QTableWidgetItem *> items) const[protected]
返回項列表中MIME資料的容器
42、QStringList QTableWidget::mimeTypes() const[protected
返回表格中所有項的一個MIME資料
43、void QTableWidget::openPersistentEditor(QTableWidgetItem * item)
開始編輯item
44、void QTableWidget::removeCellWidget(int row,int column)
刪除第row行第column列的視窗部件
45、void QTableWidget::removeColumn(int column)[slot]
刪除第column列
46、void QTableWidget::removeRow(int row)[slot]
刪除第row行
47、int QTableWidget::row(constQTableWidgetItem * item) const[slot]
返回指定item所在的行數
48、void QTableWidget::scrollToItem(constQTableWidgetItem * item, QAbstractItemView::ScrollHint hint = EnsureVisible)[slot]
指定的item比較突顯出來,方便辨認。
49、QList<QTableWidgetItem *> QTableWidget::selectedItems()
返回選中的項的列表
50、QList<QTableWidgetSelectionRange> QTableWidget::selectedRanges() const
返回選擇範圍
51、void QTableWidget::setCellWidget(int row,int column, QWidget * widget)
將widget視窗部件放到第row行第column列。
52、void QTableWidget::setCurrentCell(int row,int column)
將位於第row行第column列的項設定為當前項(獲取焦點)
53、void QTableWidget::setCurrentItem(QTableWidgetItem * item)
設定指定的item為當前項
54、void QTableWidget::setHorizontalHeaderItem(int column,QTableWidgetItem * item)
將第column列的水平表頭項設為item
55、void QTableWidget::setHorizontalHeaderLabels(constQStringList & labels)
使用一組標籤設定水平表頭
56、void QTableWidget::setItem(int row,int column, QTableWidgetItem * item)
設定第row行第column列的項;注意如果使能排序,行位置會變化
57、void QTableWidget::setItemPrototype(constQTableWidgetItem * item)
通過item設定表的標準項模型。
58、void QTableWidget::setRangeSelected(constQTableWidgetSelectionRange & range, bool select)
選擇或取消範圍
59、void QTableWidget::setVerticalHeaderItem(int row,QTableWidgetItem * item)
設定第row行的垂直表頭的項
60、void QTableWidget::setVerticalHeaderLabels(constQStringList & labels)
通過一組標籤設定垂直表頭
61、void QTableWidget::sortItems(int column,Qt::SortOrder order = Qt::AscendingOrder)
根據規則order設定第column列的所有行
62、Qt::DropActions QTableWidget::supportedDropActions() const
返回該表支援的所有拖放操作
63、QTableWidgetItem * QTableWidget::takeHorizontalHeaderItem(int column)
將項從第column列的水平表頭中去除,但不刪除它(不delete item)。
64、QTableWidgetItem * QTableWidget::takeItem(int row,int column)
將項從第row行第column列去除,但不刪除它
65、QTableWidgetItem * QTableWidget::verticalHeaderItem(int row) const
返回垂直表頭中第row行的項
66、int QTableWidget::visualColumn(int logicalColumn) const
返回給定邏輯列的可視列。
67、QRect QTableWidget::visualItemRect(constQTableWidgetItem * item) const
返回item所佔的單元格的位置和大小
68、int QTableWidget::visualRow(int logicalRow) const
返回給定邏輯行的可視行。