Q3Table Class Reference
[Qt3Support module]

Cells

All of a Q3Table's cells are empty when the table is constructed.

There are two approaches to populating the table's cells. The first and simplest approach is to use Q3TableItems or Q3TableItem subclasses. The second approach doesn't use Q3TableItems at all which is useful for very large sparse tables but requires you to reimplement a number of functions. We'll look at each approach in turn.

To put a string in a cell use setText(). This function will create a new Q3TableItem for the cell if one doesn't already exist, and displays the text in it. By default the table item's widget will be a QLineEdit. A pixmap may be put in a cell with setPixmap(), which also creates a table item if required. A cell may contain both a pixmap and text; the pixmap is displayed to the left of the text. Another approach is to construct a Q3TableItem or Q3TableItem subclass, set its properties, then insert it into a cell with setItem().

If you want cells which contain comboboxes use the Q3ComboTableItem class. Similarly if you require cells containing checkboxes use the Q3CheckTableItem class. These table items look and behave just like the combobox or checkbox widgets but consume far less memory.

Q3Table takes ownership of its Q3TableItems and will delete them when the table itself is destroyed. You can take ownership of a table item using takeItem() which you use to move a cell's contents from one cell to another, either within the same table, or from one table to another. (See also, swapCells()).

In-place editing of the text in Q3TableItems, and the values in Q3ComboTableItems and Q3CheckTableItems works automatically. Cells may be editable or read-only, see Q3TableItem::EditType. If you want fine control over editing see beginEdit() and endEdit().

The contents of a cell can be retrieved as a Q3TableItem using item(), or as a string with text() or as a pixmap (if there is one) with pixmap(). A cell's bounding rectangle is given by cellGeometry(). Use updateCell() to repaint a cell, for example to clear away a cell's visual representation after it has been deleted with clearCell(). The table can be forced to scroll to show a particular cell with ensureCellVisible(). The isSelected() function indicates if a cell is selected.

It is possible to use your own widget as a cell's widget using setCellWidget(), but subclassing Q3TableItem might be a simpler approach. The cell's widget (if there is one) can be removed with clearCellWidget().

 Q3TableItem *i = item(row, col);
 if (initFromCell || (i && !i->isReplaceable()))
     // If we had a Q3TableItem ask the base class to create the editor
     return Q3Table::createEditor(row, col, initFromCell);
 else
     return ...(create your own editor)

 p->setClipRect(cellRect(row, col), QPainter::CoordPainter);
 //... your drawing code
 p->setClipping(false);