Qt中通过自定义委托实现QTableView复选框居中对齐
在使用QTableView时,若需在单元格中显示复选框,通常通过设置QStandardItem的checkable属性实现。然而,默认情况下复选框靠左对齐,并附带文本区域,无法满足居中显示的需求。为实现复选框在单元格内水平垂直居中,需继承QStyledItemDelegate并重写其绘制与事件处理方法。
核心思路是:不使用默认的绘制逻辑,而是手动计算复选框指示器的位置,并将其绘制在单元格中心。同时,拦截鼠标事件以判断点击是否落在复选框区域内,从而触发状态切换。
关键实现步骤
创建一个自定义委托类,如CenterCheckBoxDelegate,覆盖两个关键函数:
- paint():负责绘制复选框图形。
- editorEvent():处理用户交互,例如鼠标点击。
代码实现
#ifndef CENTERCHECKBOXDELEGATE_H
#define CENTERCHECKBOXDELEGATE_H
#include <QStyledItemDelegate>
class CenterCheckBoxDelegate : public QStyledItemDelegate
{
Q_OBJECT
public:
explicit CenterCheckBoxDelegate(QObject *parent = nullptr);
void paint(QPainter *painter,
const QStyleOptionViewItem &option,
const QModelIndex &index) const override;
bool editorEvent(QEvent *event,
QAbstractItemModel *model,
const QStyleOptionViewItem &option,
const QModelIndex &index) override;
signals:
void stateChanged(const QModelIndex &index, bool checked);
};
#endif // CENTERCHECKBOXDELEGATE_H
#include "CenterCheckBoxDelegate.h"
#include <QApplication>
#include <QMouseEvent>
#include <QPainter>
CenterCheckBoxDelegate::CenterCheckBoxDelegate(QObject *parent)
: QStyledItemDelegate(parent)
{
}
void CenterCheckBoxDelegate::paint(QPainter *painter,
const QStyleOptionViewItem &option,
const QModelIndex &index) const
{
// 构造用于绘制复选框的状态选项
QStyleOptionButton checkboxStyle;
checkboxStyle.initFrom(option.widget);
checkboxStyle.state |= QStyle::State_Enabled;
// 获取当前复选框状态
bool isChecked = index.data(Qt::CheckStateRole).toBool();
if (isChecked) {
checkboxStyle.state |= QStyle::State_On;
} else {
checkboxStyle.state |= QStyle::State_Off;
}
// 处理选中背景
if (option.state & (QStyle::State_Selected | QStyle::State_HasFocus)) {
painter->fillRect(option.rect, option.palette.highlight());
}
// 获取系统样式中的复选框指示器区域并居中
QRect indicatorRect = QApplication::style()->subElementRect(
QStyle::SE_CheckBoxIndicator, &checkboxStyle, option.widget);
indicatorRect.moveCenter(option.rect.center());
checkboxStyle.rect = indicatorRect;
// 使用当前样式绘制复选框
QApplication::style()->drawControl(QStyle::CE_CheckBox, &checkboxStyle, painter);
}
bool CenterCheckBoxDelegate::editorEvent(QEvent *event,
QAbstractItemModel *model,
const QStyleOptionViewItem &option,
const QModelIndex &index)
{
// 忽略双击事件,防止误操作
if (event->type() == QEvent::MouseButtonDblClick) {
return true;
}
// 仅响应鼠标释放事件
if (event->type() == QEvent::MouseButtonRelease) {
QMouseEvent *mouse = static_cast<QMouseEvent*>(event);
QStyleOptionButton tmpOption;
QRect boxArea = QApplication::style()->subElementRect(
QStyle::SE_CheckBoxIndicator, &tmpOption, option.widget);
boxArea.moveCenter(option.rect.center());
// 判断点击位置是否在复选框范围内
if (boxArea.contains(mouse->pos())) {
bool currentState = model->data(index, Qt::CheckStateRole).toBool();
bool newState = !currentState;
// 更新模型数据
model->setData(index, newState, Qt::CheckStateRole);
emit stateChanged(index, newState); // 发出状态变更信号
return true;
}
}
return QStyledItemDelegate::editorEvent(event, model, option, index);
}
使用方式
将自定义委托应用到目标列即可:
auto *delegate = new CenterCheckBoxDelegate(this);
ui->tableView->setItemDelegateForColumn(0, delegate);
connect(delegate, &CenterCheckBoxDelegate::stateChanged,
this, [this](const QModelIndex &idx, bool checked) {
// 处理状态变化
qDebug() << "Row:" << idx.row() << "Checked:" << checked;
});
该方案兼容不同平台的Qt样式,确保复选框外观与系统风格一致,同时实现精确的居中布局和可靠的交互响应。