How to Use QTableWidget

[toc align_right="yes" depth="3"]

English Български

How to Use QTableWidget

QTableWidget Overview

Using "QTableWidget":http://doc.qt.io/qt-5.0/qtwidgets/qtablewidget.html developers can embed tables inside Qt applications. QTableWidget inherits "QTableView":http://doc.qt.io/qt-5.0/qtwidgets/qtableview.html. Items in a QTableWidget instance are provided by class "QTableWidgetItem":http://doc.qt.io/qt-5.0/qtwidgets/qtablewidgetitem.html.

Basic Usage

Set number of rows and columns

m_pTableWidget-&gt;setRowCount(10);<br />m_pTableWidget-&gt;setColumnCount(3);

Insert labels into the horizontal header

m_TableHeader&amp;lt;&lt;&quot;#&quot;&lt;&lt;&quot;Name&amp;quot;&lt;&lt;&quot;Text&amp;quot;;<br />m_pTableWidget-&gt;setHorizontalHeaderLabels(m_TableHeader);

Insert data

The simplest way to insert text into a cell:

m_pTableWidget-&gt;setItem(0, 1, new QTableWidgetItem(&quot;Hello&amp;quot;));<code>

==== Hide vertical header aka the line counter ====

m_pTableWidget->verticalHeader()>setVisible(false);

h4. Hide grid

m_pTableWidget</s>&gt;setShowGrid(false);<code>

==== Set background of the selected items ====

m_pTableWidget->setStyleSheet("QTableView {selection-background-color: red;}");

Disable editing

m_pTableWidget-&gt;setEditTriggers(QAbstractItemView::NoEditTriggers);<code>

==== Selection mode and behavior ====

The behavior of the table for selecting rows and cells can be customized using methods &quot;setSelectionBehavior&amp;quot;:http://doc.qt.io/qt-5.0/qtwidgets/qabstractitemview.html#SelectionBehavior-enum and &quot;setSelectionMode&amp;quot;:http://doc.qt.io/qt-5.0/qtwidgets/qabstractitemview.html#SelectionMode-enum. The following example allows only single selection of a row:

m_pTableWidget->setSelectionBehavior(QAbstractItemView::SelectRows);
m_pTableWidget->setSelectionMode(QAbstractItemView::SingleSelection);

==== Handling signals ====

QTableWidget provides appropriate "signals for each event such as change of selection, click, double click, etc. ":http://doc.qt.nokia.com/latest/qtablewidget.html#signals Example of handling double click of a cell:

connect( m_pTableWidget, SIGNAL( cellDoubleClicked (int, int) ), this, SLOT( cellSelected( int, int ) ) );

Example

The following code snippet uses QTableWidget and all described cases above. It has been tested on Symbian^3 device.

• mainwindow.h

#include &lt;QTableWidget&amp;gt;<code>

private slots:

void cellSelected(int nRow, int nCol);

private:

QTableWidget* m_pTableWidget;

QStringList m_TableHeader;

* mainwindow.cpp

#include "mainwindow.h"

1. include <QApplication&gt;
   #include <QDesktopWidget&gt;
   #include <QtCore/QCoreApplication&gt;
   #include <QHeaderView&gt;
   #include <QMessageBox&gt;

MainWindow::MainWindow(QWidget *parent)
 : QMainWindow(parent),
m_pTableWidget(NULL)
{
m_pTableWidget = new QTableWidget(this);
m_pTableWidget->setRowCount(10);
m_pTableWidget->setColumnCount(3);
m_TableHeader&lt;<"#"<<"Name&quot;<<"Text&quot;;
m_pTableWidget->setHorizontalHeaderLabels(m_TableHeader);
m_pTableWidget->verticalHeader()>setVisible(false);
m_pTableWidget>setEditTriggers(QAbstractItemView::NoEditTriggers);
m_pTableWidget->setSelectionBehavior(QAbstractItemView::SelectRows);
m_pTableWidget->setSelectionMode(QAbstractItemView::SingleSelection);
m_pTableWidget->setShowGrid(false);
m_pTableWidget->setStyleSheet("QTableView {selection-background-color: red;}");
m_pTableWidget->setGeometry(QApplication::desktop()>screenGeometry());
//insert data
m_pTableWidget>setItem(0, 1, new QTableWidgetItem("Hello&quot;));

connect( m_pTableWidget, SIGNAL( cellDoubleClicked (int, int) ),
this, SLOT( cellSelected( int, int ) ) );
}

MainWindow::~MainWindow()
{
}

void MainWindow::cellSelected(int nRow, int nCol)
{
QMessageBox::information(this, "",
"Cell at row "QString::number(nRow)
" column "QString::number(nCol)
" was double clicked.");
}

See Also

"How to use QTableWidget in Qt&quot;:http://www.developer.nokia.com/Community/Wiki/index.php?title=How_to_use_QTableWidget_in_Qt