Important: Please read the Qt Code of Conduct -

How to center a column with a checkbox in QTableView?

  • I was able to get my QTableView widget to display a checkbox by returning Qt::CheckState in the model's data() function. However, it shows it left aligned in the column. I looked at the delegate stuff but can't figure out how to change the default alignment of a column without subclassing QAbstractItemDelegate, which seems like way too much work for this.

    Thanks for any help!

  • Lifetime Qt Champion

    You're correct - the only way to do so is to write your own delegate (derived from QStyledItemDelegate)

  • This is such a common use case that there are literally no trustworthy examples for beginners for this case.

    It'd make QT more of a pleasure to get into if there were examples for these common patterns. I agree with the OP that this is just a large amount of code for such a simple thing.

    Maybe even the components should just support this out of the box with minimal code. Why hasn't this been done though?

  • You can try a different use...
    Add QWidget instead of QCheckBox in your QTableView.
    for example:

     QWidget * checkWidget = new QWidget(this);
     QCheckBox * check = new QCheckBox(this);
     QHBoxLayout * checkLayout = new QHBoxLayout(checkWidget);

    // add checkWidget to QTableView

  • Lifetime Qt Champion

    And how to you set the value from the model? Using setIndexWidget is definitely no way to go.
    @gurpal2000 : fell free to provide a patch to Qt so it gets integrated... you can add me as reviewer.

  • This post is deleted!

  • This post is deleted!

  • Try something like this:

    #include <QApplication>
    #include <QTableWidget>
    #include <QStandardItemModel>
    #include <QProxyStyle>
    #include <QStyleOptionViewItem>
    enum {
      CheckAlignmentRole = Qt::UserRole + Qt::CheckStateRole + Qt::TextAlignmentRole
    class CenteredBoxProxy : public QProxyStyle{
        QRect subElementRect(QStyle::SubElement element, const QStyleOption *option, const QWidget *widget) const override{
            const QRect baseRes = QProxyStyle::subElementRect(element, option, widget);
                const QStyleOptionViewItem* const itemOpt = qstyleoption_cast<const QStyleOptionViewItem*>(option) ;
                const QVariant alignData = itemOpt->;
                   return baseRes;
                const QRect itemRect = option->rect;
                Q_ASSERT(itemRect.width()>baseRes.width() && itemRect.height()>baseRes.height());
                const int alignFlag = alignData.toInt();
                int x=0,y=0;
                if(alignFlag & Qt::AlignLeft){
                else if(alignFlag & Qt::AlignRight){
                    x=itemRect.x() + itemRect.width() - (baseRes.x()-itemRect.x())-baseRes.width();
                else if(alignFlag & Qt::AlignHCenter){
                    x=itemRect.x() + (itemRect.width()/2)-(baseRes.width()/2);
                return QRect(QPoint(x,baseRes.y()), baseRes.size());
            return baseRes;
    int main(int argc, char **argv)
        QApplication app(argc,argv);
        app.setStyle(new CenteredBoxProxy);
        QTableView wid;
        QStandardItemModel* model = new QStandardItemModel(&wid);
        for(int i=0;i<10;++i){
            model->setData(model->index(i,0), i%2==0 ? Qt::Unchecked : Qt::Checked, Qt::CheckStateRole);
            model->setData(model->index(i,0), Qt::AlignCenter, CheckAlignmentRole);
            model->setData(model->index(i,1), i%2==0 ? Qt::Unchecked : Qt::Checked, Qt::CheckStateRole);
            model->setData(model->index(i,2), i);
            model->item(i,0)->setFlags(model->item(i,0)->flags() | Qt::ItemIsUserCheckable);
        return app.exec();

  • @VRonin ... THANK YOU! This works very well.

  • I saw this in qstyle.h in the "enum SubElement":

        SE_ViewItemCheckIndicator, // ### Qt 6: remove
        SE_ItemViewItemCheckIndicator = SE_ViewItemCheckIndicator,

    I assume that SE_ItemViewItemCheckIndicator is safe to continue to use?

  • Lifetime Qt Champion


    Yes it is.

  • I have adapted the code a little bit to take care of the focus rectangle which is also centered now. Of course, I will include a link to this forum topic in my code, which will be open source (thanks again, @VRonin :)

    #include <QProxyStyle>
    #include <QStyleOptionViewItem>
    enum {
      CheckAlignmentRole = Qt::UserRole
                         + Qt::CheckStateRole
                         + Qt::TextAlignmentRole
    class CenteredBoxProxy : public QProxyStyle {
      QRect subElementRect(QStyle::SubElement element,
                           const QStyleOption *option,
                           const QWidget *widget) const override {
        const QRect baseRes = QProxyStyle::subElementRect(element, option, widget);
        const QRect itemRect = option->rect;
        QRect retval = baseRes;
        QSize sz = baseRes.size();
        const QStyleOptionViewItem* const
            itemOpt = qstyleoption_cast<const QStyleOptionViewItem*>(option);
        if (itemOpt) {
          const QVariant alignData = itemOpt->;
          if(!alignData.isNull()) {
            const uint alignFlag = alignData.toUInt();
            if (alignFlag & Qt::AlignHCenter) {
              if (element == SE_ItemViewItemCheckIndicator) {
                int x = itemRect.x() + (itemRect.width()/2) - (baseRes.width()/2);
                retval = QRect( QPoint(x, baseRes.y()), sz);
              } else if (element == SE_ItemViewItemFocusRect) {
                retval = QRect( QPoint(0, baseRes.y()), sz);
        return retval;

  • Lifetime Qt Champion

    Thanks for the update !

  • @Robert-Hairgrove said in How to center a column with a checkbox in QTableView?:

    retval = QRect( QPoint(0, baseRes.y()), sz);

    This seams dodgy. Could you try making the second column the one with the centred checkbox and see if it still works as expected

  • @VRonin ... Looks OK to me. But thanks for the suggestion, because I should have tried this myself before posting the update (and I hadn't).

    The normal behavior for item views seems to be this:

    1. When the widget has focus, the view item's focus indicator fills out the background of the entire item rectangle and is darker in color (e.g. when navigating the view with the arrow keys);
    2. When the widget goes out of focus (e.g. clicking outside of the entire widget), there is another focus indicator which is shown, lighter in color, but only over the text normally accompanying the checkbox -- not over the checkbox itself.

    When the checkbox has no text (i.e. when it is centered), this seems a little odd. This update "fixes" the non-focussed focus rectangle. :)

  • Sorry I should have been more specific, my only concern is on having 0 as first argument to QPoint there as I think it's in coordinates of the scrollarea not of the item itself so my concern is that if the checkbox is in any column except the first column, retval would still point somewhere in the first column

Log in to reply