[Qt]自定義表頭實現過濾功能
1. 寫在前面
過濾功能源自專案上互動優化使用者體驗,在表頭新增過濾符號實現過濾,替換以往在表格上方佔用一行過濾項進行過濾。
2. 過濾提示
過濾提示就是三態圖示(normal,hover,press)。這三種狀態的實現通過滑鼠移動事件和滑鼠點選事件來實現。具體實現如下:
1)hover狀態在滑鼠移動事件中實現
void CFilterHeaderView::mouseMoveEvent(QMouseEvent *e) { m_hover = logicalIndexAt(e->pos()); if (m_hover != -1) updateSection(m_hover); QHeaderView::mouseMoveEvent(e); } bool CFilterHeaderView::event(QEvent *e) { switch(e->type()) { case QEvent::Leave: case QEvent::HoverLeave: if (m_hover != -1) updateSection(m_hover); m_hover = -1; break; default: break; } return QHeaderView::event(e); }
如果懸浮在某一列上,hover值等於該列的index,否則等於-1。如果hover值不等於-1,則重新整理該列(updateSection)。
mouseMoveEvent中檢測滑鼠懸浮在那個表格列上。event函式中監聽Leave和HoverLeave事件。
2)press狀態在滑鼠點選事件中實現
void CFilterHeaderView::mousePressEvent(QMouseEvent *e) { m_press = logicalIndexAt(e->pos()); if (m_press != -1) updateSection(m_press); QHeaderView::mousePressEvent(e); } void CFilterHeaderView::mouseReleaseEvent(QMouseEvent *e) { m_press = -1; QHeaderView::mouseReleaseEvent(e); }
press的實現較為簡單,滑鼠點選更新press,滑鼠釋放press置為-1。
3)過濾提示的實現。
過濾提示在paintSection函式中實現,首先是呼叫基類paintSection實現表頭的繪製,然後是檢測有沒有定義過濾角色。如果有定義過濾角色,則根據三態選擇對應的圖示,繪製位置預設水平靠右垂直居住,也可以自己指定位置。最後是繪製過濾提示。具體實現如下:
void CFilterHeaderView::paintSection(QPainter *painter, const QRect &rect, int logicalIndex) const { painter->save(); QHeaderView::paintSection(painter, rect, logicalIndex); painter->restore(); QVariant filterVar = model()->headerData(logicalIndex, orientation(), FilterRole); if (filterVar.isValid() && filterVar.toBool()) { QPixmap pix = m_norFilterPix; bool b_contain = getFilterRect(rect).contains(cursor().pos()); if (logicalIndex == m_hover && b_contain) { pix = m_hovFilterPix; } if (logicalIndex == m_press && b_contain) { pix = m_preFilterPix; } int align = Qt::AlignRight | Qt::AlignVCenter; QVariant alignVar = model()->headerData(logicalIndex, orientation(), FilterAlignmentRole); if (alignVar.isValid()) { align = alignVar.toInt(); } style()->drawItemPixmap(painter, rect, align, pix); } }
表格繪製的區域和過濾提示繪製的區域不一致,要根據過濾圖示大小進行計算過濾提示的區域。只有當滑鼠在過濾區域位置上方,hover和press才有效,否則仍然是normal狀態。過濾區域繪製的位置可以從外面獲取,也可以使用預設位置。最後style()->drawItemPixmap進行繪製。
呼叫基類paintSection方法前後呼叫QPainter::save()和QPainter::restore()是必要的。如果不呼叫,style()->drawItemPixmap是不會起作用的。
4)過濾提示點選訊號
點選過濾提示會發出訊號,連線此訊號可以進行過濾功能的實現。具體實現如下:
void CFilterHeaderView::mouseReleaseEvent(QMouseEvent *e) { if (e->button() == Qt::LeftButton) { int section = logicalIndexAt(e->pos()); QVariant filterVar = model()->headerData(section, orientation(), FilterRole); if (filterVar.isValid() && filterVar.toBool()) { QRect rect(sectionViewportPosition(section), 0, sectionSize(section), height()); if (getFilterRect(rect).contains(cursor().pos())) { emit filterClicked(section); } } } QHeaderView::mouseReleaseEvent(e); }
過濾訊號發出的條件:1. 左鍵點選,2. 定義了過濾功能,3. 滑鼠在過濾提示區域中
3. 使用過濾功能
使用過濾表頭的方法如下:
m_tableView = new QTableView(this); m_model = new QStandardItemModel(this); m_filterModel = new QSortFilterProxyModel(this); m_filterModel->setSourceModel(m_model); m_filterModel->setSortRole(Qt::ToolTipRole); m_tableView->setModel(m_filterModel); QHBoxLayout* mainLayout = new QHBoxLayout(this); mainLayout->setMargin(0); mainLayout->addWidget(m_tableView); setLayout(mainLayout); m_tableView->setEditTriggers(QAbstractItemView::NoEditTriggers); m_tableView->setSelectionMode(QAbstractItemView::SingleSelection); m_tableView->setSelectionBehavior(QAbstractItemView::SelectRows); m_tableView->verticalHeader()->hide(); CFilterHeaderView* pHeader = new CFilterHeaderView(this); connect(pHeader, &CFilterHeaderView::filterClicked, this, &Widget::onFilterClicked); m_tableView->setHorizontalHeader(pHeader);
使用過濾表頭和使用普通表頭沒有太大的差別。這裡過濾功能有QSortFilterProxyModel實現,水平表頭替換成自定義的CFilterHeaderView。
4. 寫在最後
實現過濾表頭的原理如上所訴。具體完整的專案路徑參考如下地址:
https://github.com/zhugp125/QtDemo/tree/master/FilterHeaderView