diff options
| author | Michele Calgaro <michele.calgaro@yahoo.it> | 2024-08-12 22:02:11 +0900 |
|---|---|---|
| committer | Michele Calgaro <michele.calgaro@yahoo.it> | 2024-08-12 22:02:11 +0900 |
| commit | 42957a3f812a1db64a9ae452baa2d3fbc35f2466 (patch) | |
| tree | 0928f4e01a3dcc0698b46c7608d8310e471bdb49 /doc/html/ntqtable.html | |
| parent | fef846914f8db6dc117e206ef913d519bf6bb33e (diff) | |
| download | tqt3-42957a3f812a1db64a9ae452baa2d3fbc35f2466.tar.gz tqt3-42957a3f812a1db64a9ae452baa2d3fbc35f2466.zip | |
Rename more widget nt* related files to equivalent tq*
Signed-off-by: Michele Calgaro <michele.calgaro@yahoo.it>
Diffstat (limited to 'doc/html/ntqtable.html')
| -rw-r--r-- | doc/html/ntqtable.html | 1477 |
1 files changed, 0 insertions, 1477 deletions
diff --git a/doc/html/ntqtable.html b/doc/html/ntqtable.html deleted file mode 100644 index c5a8a6a8b..000000000 --- a/doc/html/ntqtable.html +++ /dev/null @@ -1,1477 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> -<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/table/qtable.cpp:1659 --> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> -<title>TQTable Class</title> -<style type="text/css"><!-- -fn { margin-left: 1cm; text-indent: -1cm; } -a:link { color: #004faf; text-decoration: none } -a:visited { color: #672967; text-decoration: none } -body { background: #ffffff; color: black; } ---></style> -</head> -<body> - -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr bgcolor="#E5E5E5"> -<td valign=center> - <a href="index.html"> -<font color="#004faf">Home</font></a> - | <a href="classes.html"> -<font color="#004faf">All Classes</font></a> - | <a href="mainclasses.html"> -<font color="#004faf">Main Classes</font></a> - | <a href="annotated.html"> -<font color="#004faf">Annotated</font></a> - | <a href="groups.html"> -<font color="#004faf">Grouped Classes</font></a> - | <a href="functions.html"> -<font color="#004faf">Functions</font></a> -</td> -<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQTable Class Reference<br><small>[<a href="table.html">table module</a>]</small></h1> - -<p>The TQTable class provides a flexible editable table widget. -<a href="#details">More...</a> -<p><tt>#include <<a href="qtable-h.html">ntqtable.h</a>></tt> -<p>Inherits <a href="tqscrollview.html">TQScrollView</a>. -<p>Inherited by <a href="tqdatatable.html">TQDataTable</a>. -<p><a href="qtable-members.html">List of all member functions.</a> -<h2>Public Members</h2> -<ul> -<li class=fn><a href="#TQTable"><b>TQTable</b></a> ( TQWidget * parent = 0, const char * name = 0 )</li> -<li class=fn><a href="#TQTable-2"><b>TQTable</b></a> ( int numRows, int numCols, TQWidget * parent = 0, const char * name = 0 )</li> -<li class=fn><a href="#~TQTable"><b>~TQTable</b></a> ()</li> -<li class=fn>TQHeader * <a href="#horizontalHeader"><b>horizontalHeader</b></a> () const</li> -<li class=fn>TQHeader * <a href="#verticalHeader"><b>verticalHeader</b></a> () const</li> -<li class=fn>enum <a href="#SelectionMode-enum"><b>SelectionMode</b></a> { Single, Multi, SingleRow, MultiRow, NoSelection }</li> -<li class=fn>virtual void <a href="#setSelectionMode"><b>setSelectionMode</b></a> ( SelectionMode mode )</li> -<li class=fn>SelectionMode <a href="#selectionMode"><b>selectionMode</b></a> () const</li> -<li class=fn>virtual void <a href="#setItem"><b>setItem</b></a> ( int row, int col, TQTableItem * item )</li> -<li class=fn>virtual void <a href="#setText"><b>setText</b></a> ( int row, int col, const TQString & text )</li> -<li class=fn>virtual void <a href="#setPixmap"><b>setPixmap</b></a> ( int row, int col, const TQPixmap & pix )</li> -<li class=fn>virtual TQTableItem * <a href="#item"><b>item</b></a> ( int row, int col ) const</li> -<li class=fn>virtual TQString <a href="#text"><b>text</b></a> ( int row, int col ) const</li> -<li class=fn>virtual TQPixmap <a href="#pixmap"><b>pixmap</b></a> ( int row, int col ) const</li> -<li class=fn>virtual void <a href="#clearCell"><b>clearCell</b></a> ( int row, int col )</li> -<li class=fn>virtual TQRect <a href="#cellGeometry"><b>cellGeometry</b></a> ( int row, int col ) const</li> -<li class=fn>virtual int <a href="#columnWidth"><b>columnWidth</b></a> ( int col ) const</li> -<li class=fn>virtual int <a href="#rowHeight"><b>rowHeight</b></a> ( int row ) const</li> -<li class=fn>virtual int <a href="#columnPos"><b>columnPos</b></a> ( int col ) const</li> -<li class=fn>virtual int <a href="#rowPos"><b>rowPos</b></a> ( int row ) const</li> -<li class=fn>virtual int <a href="#columnAt"><b>columnAt</b></a> ( int x ) const</li> -<li class=fn>virtual int <a href="#rowAt"><b>rowAt</b></a> ( int y ) const</li> -<li class=fn>virtual int <a href="#numRows"><b>numRows</b></a> () const</li> -<li class=fn>virtual int <a href="#numCols"><b>numCols</b></a> () const</li> -<li class=fn>void <a href="#updateCell"><b>updateCell</b></a> ( int row, int col )</li> -<li class=fn>int <a href="#currentRow"><b>currentRow</b></a> () const</li> -<li class=fn>int <a href="#currentColumn"><b>currentColumn</b></a> () const</li> -<li class=fn>void <a href="#ensureCellVisible"><b>ensureCellVisible</b></a> ( int row, int col )</li> -<li class=fn>bool <a href="#isSelected"><b>isSelected</b></a> ( int row, int col ) const</li> -<li class=fn>bool <a href="#isRowSelected"><b>isRowSelected</b></a> ( int row, bool full = FALSE ) const</li> -<li class=fn>bool <a href="#isColumnSelected"><b>isColumnSelected</b></a> ( int col, bool full = FALSE ) const</li> -<li class=fn>int <a href="#numSelections"><b>numSelections</b></a> () const</li> -<li class=fn>TQTableSelection <a href="#selection"><b>selection</b></a> ( int num ) const</li> -<li class=fn>virtual int <a href="#addSelection"><b>addSelection</b></a> ( const TQTableSelection & s )</li> -<li class=fn>virtual void <a href="#removeSelection"><b>removeSelection</b></a> ( const TQTableSelection & s )</li> -<li class=fn>virtual void <a href="#removeSelection-2"><b>removeSelection</b></a> ( int num )</li> -<li class=fn>virtual int <a href="#currentSelection"><b>currentSelection</b></a> () const</li> -<li class=fn>void <a href="#selectCells"><b>selectCells</b></a> ( int start_row, int start_col, int end_row, int end_col )</li> -<li class=fn>void <a href="#selectRow"><b>selectRow</b></a> ( int row )</li> -<li class=fn>void <a href="#selectColumn"><b>selectColumn</b></a> ( int col )</li> -<li class=fn>bool <a href="#showGrid"><b>showGrid</b></a> () const</li> -<li class=fn>bool <a href="#columnMovingEnabled"><b>columnMovingEnabled</b></a> () const</li> -<li class=fn>bool <a href="#rowMovingEnabled"><b>rowMovingEnabled</b></a> () const</li> -<li class=fn>virtual void <a href="#sortColumn"><b>sortColumn</b></a> ( int col, bool ascending = TRUE, bool wholeRows = FALSE )</li> -<li class=fn>bool <a href="#sorting"><b>sorting</b></a> () const</li> -<li class=fn>virtual void <a href="#takeItem"><b>takeItem</b></a> ( TQTableItem * i )</li> -<li class=fn>virtual void <a href="#setCellWidget"><b>setCellWidget</b></a> ( int row, int col, TQWidget * e )</li> -<li class=fn>virtual TQWidget * <a href="#cellWidget"><b>cellWidget</b></a> ( int row, int col ) const</li> -<li class=fn>virtual void <a href="#clearCellWidget"><b>clearCellWidget</b></a> ( int row, int col )</li> -<li class=fn>virtual TQRect <a href="#cellRect"><b>cellRect</b></a> ( int row, int col ) const</li> -<li class=fn>virtual void <a href="#paintCell-2"><b>paintCell</b></a> ( TQPainter * p, int row, int col, const TQRect & cr, bool selected )</li> -<li class=fn>virtual void <a href="#paintCell"><b>paintCell</b></a> ( TQPainter * p, int row, int col, const TQRect & cr, bool selected, const TQColorGroup & cg )</li> -<li class=fn>virtual void <a href="#paintFocus"><b>paintFocus</b></a> ( TQPainter * p, const TQRect & cr )</li> -<li class=fn>bool <a href="#isReadOnly"><b>isReadOnly</b></a> () const</li> -<li class=fn>bool <a href="#isRowReadOnly"><b>isRowReadOnly</b></a> ( int row ) const</li> -<li class=fn>bool <a href="#isColumnReadOnly"><b>isColumnReadOnly</b></a> ( int col ) const</li> -<li class=fn>void <a href="#repaintSelections"><b>repaintSelections</b></a> ()</li> -<li class=fn>enum <a href="#FocusStyle-enum"><b>FocusStyle</b></a> { FollowStyle, SpreadSheet }</li> -<li class=fn>virtual void <a href="#setFocusStyle"><b>setFocusStyle</b></a> ( FocusStyle fs )</li> -<li class=fn>FocusStyle <a href="#focusStyle"><b>focusStyle</b></a> () const</li> -<li class=fn>void <a href="#updateHeaderStates"><b>updateHeaderStates</b></a> ()</li> -</ul> -<h2>Public Slots</h2> -<ul> -<li class=fn>virtual void <a href="#setNumRows"><b>setNumRows</b></a> ( int r )</li> -<li class=fn>virtual void <a href="#setNumCols"><b>setNumCols</b></a> ( int r )</li> -<li class=fn>virtual void <a href="#setShowGrid"><b>setShowGrid</b></a> ( bool b )</li> -<li class=fn>virtual void <a href="#hideRow"><b>hideRow</b></a> ( int row )</li> -<li class=fn>virtual void <a href="#hideColumn"><b>hideColumn</b></a> ( int col )</li> -<li class=fn>virtual void <a href="#showRow"><b>showRow</b></a> ( int row )</li> -<li class=fn>virtual void <a href="#showColumn"><b>showColumn</b></a> ( int col )</li> -<li class=fn>bool <a href="#isRowHidden"><b>isRowHidden</b></a> ( int row ) const</li> -<li class=fn>bool <a href="#isColumnHidden"><b>isColumnHidden</b></a> ( int col ) const</li> -<li class=fn>virtual void <a href="#setColumnWidth"><b>setColumnWidth</b></a> ( int col, int w )</li> -<li class=fn>virtual void <a href="#setRowHeight"><b>setRowHeight</b></a> ( int row, int h )</li> -<li class=fn>virtual void <a href="#adjustColumn"><b>adjustColumn</b></a> ( int col )</li> -<li class=fn>virtual void <a href="#adjustRow"><b>adjustRow</b></a> ( int row )</li> -<li class=fn>virtual void <a href="#setColumnStretchable"><b>setColumnStretchable</b></a> ( int col, bool stretch )</li> -<li class=fn>virtual void <a href="#setRowStretchable"><b>setRowStretchable</b></a> ( int row, bool stretch )</li> -<li class=fn>bool <a href="#isColumnStretchable"><b>isColumnStretchable</b></a> ( int col ) const</li> -<li class=fn>bool <a href="#isRowStretchable"><b>isRowStretchable</b></a> ( int row ) const</li> -<li class=fn>virtual void <a href="#setSorting"><b>setSorting</b></a> ( bool b )</li> -<li class=fn>virtual void <a href="#swapRows"><b>swapRows</b></a> ( int row1, int row2, bool swapHeader = FALSE )</li> -<li class=fn>virtual void <a href="#swapColumns"><b>swapColumns</b></a> ( int col1, int col2, bool swapHeader = FALSE )</li> -<li class=fn>virtual void <a href="#swapCells"><b>swapCells</b></a> ( int row1, int col1, int row2, int col2 )</li> -<li class=fn>virtual void <a href="#setLeftMargin"><b>setLeftMargin</b></a> ( int m )</li> -<li class=fn>virtual void <a href="#setTopMargin"><b>setTopMargin</b></a> ( int m )</li> -<li class=fn>virtual void <a href="#setCurrentCell"><b>setCurrentCell</b></a> ( int row, int col )</li> -<li class=fn>void <a href="#clearSelection"><b>clearSelection</b></a> ( bool repaint = TRUE )</li> -<li class=fn>virtual void <a href="#setColumnMovingEnabled"><b>setColumnMovingEnabled</b></a> ( bool b )</li> -<li class=fn>virtual void <a href="#setRowMovingEnabled"><b>setRowMovingEnabled</b></a> ( bool b )</li> -<li class=fn>virtual void <a href="#setReadOnly"><b>setReadOnly</b></a> ( bool b )</li> -<li class=fn>virtual void <a href="#setRowReadOnly"><b>setRowReadOnly</b></a> ( int row, bool ro )</li> -<li class=fn>virtual void <a href="#setColumnReadOnly"><b>setColumnReadOnly</b></a> ( int col, bool ro )</li> -<li class=fn>virtual void <a href="#setDragEnabled"><b>setDragEnabled</b></a> ( bool b )</li> -<li class=fn>bool <a href="#dragEnabled"><b>dragEnabled</b></a> () const</li> -<li class=fn>virtual void <a href="#insertRows"><b>insertRows</b></a> ( int row, int count = 1 )</li> -<li class=fn>virtual void <a href="#insertColumns"><b>insertColumns</b></a> ( int col, int count = 1 )</li> -<li class=fn>virtual void <a href="#removeRow"><b>removeRow</b></a> ( int row )</li> -<li class=fn>virtual void <a href="#removeRows"><b>removeRows</b></a> ( const TQMemArray<int> & rows )</li> -<li class=fn>virtual void <a href="#removeColumn"><b>removeColumn</b></a> ( int col )</li> -<li class=fn>virtual void <a href="#removeColumns"><b>removeColumns</b></a> ( const TQMemArray<int> & cols )</li> -<li class=fn>virtual void <a href="#editCell"><b>editCell</b></a> ( int row, int col, bool replace = FALSE )</li> -<li class=fn>void <a href="#setRowLabels"><b>setRowLabels</b></a> ( const TQStringList & labels )</li> -<li class=fn>void <a href="#setColumnLabels"><b>setColumnLabels</b></a> ( const TQStringList & labels )</li> -</ul> -<h2>Signals</h2> -<ul> -<li class=fn>void <a href="#currentChanged"><b>currentChanged</b></a> ( int row, int col )</li> -<li class=fn>void <a href="#clicked"><b>clicked</b></a> ( int row, int col, int button, const TQPoint & mousePos )</li> -<li class=fn>void <a href="#doubleClicked"><b>doubleClicked</b></a> ( int row, int col, int button, const TQPoint & mousePos )</li> -<li class=fn>void <a href="#pressed"><b>pressed</b></a> ( int row, int col, int button, const TQPoint & mousePos )</li> -<li class=fn>void <a href="#selectionChanged"><b>selectionChanged</b></a> ()</li> -<li class=fn>void <a href="#valueChanged"><b>valueChanged</b></a> ( int row, int col )</li> -<li class=fn>void <a href="#contextMenuRequested"><b>contextMenuRequested</b></a> ( int row, int col, const TQPoint & pos )</li> -<li class=fn>void <a href="#dropped"><b>dropped</b></a> ( TQDropEvent * e )</li> -</ul> -<h2>Properties</h2> -<ul> -<li class=fn>bool <a href="#columnMovingEnabled-prop"><b>columnMovingEnabled</b></a> - whether columns can be moved by the user</li> -<li class=fn>FocusStyle <a href="#focusStyle-prop"><b>focusStyle</b></a> - how the current (focus) cell is drawn</li> -<li class=fn>int <a href="#numCols-prop"><b>numCols</b></a> - the number of columns in the table</li> -<li class=fn>int <a href="#numRows-prop"><b>numRows</b></a> - the number of rows in the table</li> -<li class=fn>int <a href="#numSelections-prop"><b>numSelections</b></a> - the number of selections <em>(read only)</em></li> -<li class=fn>bool <a href="#readOnly-prop"><b>readOnly</b></a> - whether the table is read-only</li> -<li class=fn>bool <a href="#rowMovingEnabled-prop"><b>rowMovingEnabled</b></a> - whether rows can be moved by the user</li> -<li class=fn>SelectionMode <a href="#selectionMode-prop"><b>selectionMode</b></a> - the current selection mode</li> -<li class=fn>bool <a href="#showGrid-prop"><b>showGrid</b></a> - whether the table's grid is displayed</li> -<li class=fn>bool <a href="#sorting-prop"><b>sorting</b></a> - whether a click on the header of a column sorts that column</li> -</ul> -<h2>Protected Members</h2> -<ul> -<li class=fn>enum <a href="#EditMode-enum"><b>EditMode</b></a> { NotEditing, Editing, Replacing }</li> -<li class=fn>virtual void <a href="#drawContents"><b>drawContents</b></a> ( TQPainter * p, int cx, int cy, int cw, int ch )</li> -<li class=fn>void <a href="#setEditMode"><b>setEditMode</b></a> ( EditMode mode, int row, int col )</li> -<li class=fn>virtual void <a href="#contentsDragEnterEvent"><b>contentsDragEnterEvent</b></a> ( TQDragEnterEvent * e )</li> -<li class=fn>virtual void <a href="#contentsDragMoveEvent"><b>contentsDragMoveEvent</b></a> ( TQDragMoveEvent * e )</li> -<li class=fn>virtual void <a href="#contentsDragLeaveEvent"><b>contentsDragLeaveEvent</b></a> ( TQDragLeaveEvent * e )</li> -<li class=fn>virtual void <a href="#contentsDropEvent"><b>contentsDropEvent</b></a> ( TQDropEvent * e )</li> -<li class=fn>virtual TQDragObject * <a href="#dragObject"><b>dragObject</b></a> ()</li> -<li class=fn>virtual void <a href="#startDrag"><b>startDrag</b></a> ()</li> -<li class=fn>virtual void <a href="#paintEmptyArea"><b>paintEmptyArea</b></a> ( TQPainter * p, int cx, int cy, int cw, int ch )</li> -<li class=fn>virtual void <a href="#activateNextCell"><b>activateNextCell</b></a> ()</li> -<li class=fn>virtual TQWidget * <a href="#createEditor"><b>createEditor</b></a> ( int row, int col, bool initFromCell ) const</li> -<li class=fn>virtual void <a href="#setCellContentFromEditor"><b>setCellContentFromEditor</b></a> ( int row, int col )</li> -<li class=fn>virtual TQWidget * <a href="#beginEdit"><b>beginEdit</b></a> ( int row, int col, bool replace )</li> -<li class=fn>virtual void <a href="#endEdit"><b>endEdit</b></a> ( int row, int col, bool accept, bool replace )</li> -<li class=fn>virtual void <a href="#resizeData"><b>resizeData</b></a> ( int len )</li> -<li class=fn>virtual void <a href="#insertWidget"><b>insertWidget</b></a> ( int row, int col, TQWidget * w )</li> -<li class=fn>int <a href="#indexOf"><b>indexOf</b></a> ( int row, int col ) const</li> -<li class=fn>bool <a href="#isEditing"><b>isEditing</b></a> () const</li> -<li class=fn>EditMode <a href="#editMode"><b>editMode</b></a> () const</li> -<li class=fn>int <a href="#currEditRow"><b>currEditRow</b></a> () const</li> -<li class=fn>int <a href="#currEditCol"><b>currEditCol</b></a> () const</li> -</ul> -<h2>Protected Slots</h2> -<ul> -<li class=fn>virtual void <a href="#columnWidthChanged"><b>columnWidthChanged</b></a> ( int col )</li> -<li class=fn>virtual void <a href="#rowHeightChanged"><b>rowHeightChanged</b></a> ( int row )</li> -<li class=fn>virtual void <a href="#columnIndexChanged"><b>columnIndexChanged</b></a> ( int section, int fromIndex, int toIndex )</li> -<li class=fn>virtual void <a href="#rowIndexChanged"><b>rowIndexChanged</b></a> ( int section, int fromIndex, int toIndex )</li> -<li class=fn>virtual void <a href="#columnClicked"><b>columnClicked</b></a> ( int col )</li> -</ul> -<hr><a name="details"></a><h2>Detailed Description</h2> - - -The TQTable class provides a flexible editable table widget. - -<p> - - -<p> TQTable is easy to use, although it does have a large API because -of the comprehensive functionality that it provides. TQTable -includes functions for manipulating <a href="#headers">headers</a>, <a href="#columnsrows">rows and columns</a>, -<a href="#cells">cells</a> and <a href="#selections">selections</a>. TQTable also provides in-place editing and -<a href="dnd.html">drag and drop</a>, as well as a useful set of -<a href="#signals">signals</a>. TQTable efficiently supports very -large tables, for example, tables one million by one million cells -are perfectly possible. TQTable is economical with memory, using -none for unused cells. -<p> <pre> - TQTable *table = new TQTable( 100, 250, this ); - table-><a href="#setPixmap">setPixmap</a>( 3, 2, pix ); - table-><a href="#setText">setText</a>( 3, 2, "A pixmap" ); - </pre> - -<p> The first line constructs the table specifying its size in rows -and columns. We then insert a pixmap and some text into the <em>same</em> <a href="#cells">cell</a>, with the pixmap appearing to the -left of the text. TQTable cells can be populated with -<a href="qtableitem.html">TQTableItem</a>s, <a href="tqcombotableitem.html">TQComboTableItem</a>s or by <a href="tqchecktableitem.html">TQCheckTableItem</a>s. -By default a vertical header appears at the left of the table -showing row numbers and a horizontal header appears at the top of -the table showing column numbers. (The numbers displayed start at -1, although row and column numbers within TQTable begin at 0.) -<p> If you want to use mouse tracking call <a href="tqwidget.html#setMouseTracking">setMouseTracking</a>( TRUE ) on -the <em>viewport</em>; (see <a href="tqscrollview.html#allviews">TQScrollView</a>). -<p> <center><img src="qtableitems.png" alt="Table Items"></center> -<p> <a name="headers"></a> -<h3> Headers -</h3> -<a name="1"></a><p> TQTable supports a header column, e.g. to display row numbers, and -a header row, e.g to display column titles. To set row or column -labels use <a href="ntqheader.html#setLabel">TQHeader::setLabel</a>() on the pointers returned by -<a href="#verticalHeader">verticalHeader</a>() and <a href="#horizontalHeader">horizontalHeader</a>() respectively. The vertical -header is displayed within the table's left margin whose width is -set with <a href="#setLeftMargin">setLeftMargin</a>(). The horizontal header is displayed -within the table's top margin whose height is set with -<a href="#setTopMargin">setTopMargin</a>(). The table's grid can be switched off with -<a href="#setShowGrid">setShowGrid</a>(). If you want to hide a horizontal header call -<a href="tqwidget.html#hide">hide</a>(), and call setTopMargin( 0 ) so that the area the header -would have occupied is reduced to zero size. -<p> Header labels are indexed via their section numbers. Note that the -default behavior of <a href="ntqheader.html">TQHeader</a> regarding section numbers is overriden -for TQTable. See the explanation below in the Rows and Columns -section in the discussion of moving columns and rows. -<p> <a name="columnsrows"></a> -<h3> Rows and Columns -</h3> -<a name="1-1"></a><p> Row and column sizes are set with <a href="#setRowHeight">setRowHeight</a>() and -<a href="#setColumnWidth">setColumnWidth</a>(). If you want a row high enough to show the -tallest item in its entirety, use <a href="#adjustRow">adjustRow</a>(). Similarly, to make -a column wide enough to show the widest item use <a href="#adjustColumn">adjustColumn</a>(). -If you want the row height and column width to adjust -automatically as the height and width of the table changes use -<a href="#setRowStretchable">setRowStretchable</a>() and <a href="#setColumnStretchable">setColumnStretchable</a>(). -<p> Rows and columns can be hidden and shown with <a href="#hideRow">hideRow</a>(), -<a href="#hideColumn">hideColumn</a>(), <a href="#showRow">showRow</a>() and <a href="#showColumn">showColumn</a>(). New rows and columns are -inserted using <a href="#insertRows">insertRows</a>() and <a href="#insertColumns">insertColumns</a>(). Additional rows -and columns are added at the bottom (rows) or right (columns) if -you set <a href="#setNumRows">setNumRows</a>() or <a href="#setNumCols">setNumCols</a>() to be larger than <a href="#numRows">numRows</a>() -or <a href="#numCols">numCols</a>(). Existing rows and columns are removed with -<a href="#removeRow">removeRow</a>() and <a href="#removeColumn">removeColumn</a>(). Multiple rows and columns can be -removed with <a href="#removeRows">removeRows</a>() and <a href="#removeColumns">removeColumns</a>(). -<p> Rows and columns can be set to be moveable using -<a href="#rowMovingEnabled">rowMovingEnabled</a>() and <a href="#columnMovingEnabled">columnMovingEnabled</a>(). The user can drag -them to reorder them holding down the Ctrl key and dragging the -mouse. For performance reasons, the default behavior of <a href="ntqheader.html">TQHeader</a> -section numbers is overridden by TQTable. Currently in TQTable, when -a row or column is dragged and reordered, the section number is -also changed to its new position. Therefore, there is no -difference between the section and the index fields in TQHeader. -The TQTable TQHeader classes do not provide a mechanism for indexing -independently of the user interface ordering. -<p> The table can be sorted using <a href="#sortColumn">sortColumn</a>(). Users can sort a -column by clicking its header if <a href="#setSorting">setSorting</a>() is set to TRUE. Rows -can be swapped with <a href="#swapRows">swapRows</a>(), columns with <a href="#swapColumns">swapColumns</a>() and -cells with <a href="#swapCells">swapCells</a>(). -<p> For editable tables (see <a href="#setReadOnly">setReadOnly</a>()) you can set the read-only -property of individual rows and columns with <a href="#setRowReadOnly">setRowReadOnly</a>() and -<a href="#setColumnReadOnly">setColumnReadOnly</a>(). (Whether a cell is editable or read-only -depends on these settings and the cell's <a href="qtableitem.html#wheneditable">TQTableItem::EditType</a>.) -<p> The row and column which have the focus are returned by -<a href="#currentRow">currentRow</a>() and <a href="#currentColumn">currentColumn</a>() respectively. -<p> Although many TQTable functions operate in terms of rows and -columns the <a href="#indexOf">indexOf</a>() function returns a single integer -identifying a particular cell. -<p> <a name="cells"></a> -<h3> Cells -</h3> -<a name="1-2"></a><p> All of a TQTable's cells are empty when the table is constructed. -<p> There are two approaches to populating the table's cells. The -first and simplest approach is to use TQTableItems or <a href="qtableitem.html">TQTableItem</a> -subclasses. The second approach doesn't use TQTableItems 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. -<p> To put a string in a cell use <a href="#setText">setText</a>(). This function will create -a new TQTableItem 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 <a href="tqlineedit.html">TQLineEdit</a>. A pixmap may be put in a cell with <a href="#setPixmap">setPixmap</a>(), -which also creates a table item if required. A cell may contain <em>both</em> a pixmap and text; the pixmap is displayed to the left of the -text. Another approach is to construct a TQTableItem or TQTableItem -subclass, set its properties, then insert it into a cell with -<a href="#setItem">setItem</a>(). -<p> If you want cells which contain comboboxes use the <a href="tqcombotableitem.html">TQComboTableItem</a> -class. Similarly if you require cells containing checkboxes use -the <a href="tqchecktableitem.html">TQCheckTableItem</a> class. These table items look and behave just -like the combobox or checkbox widgets but consume far less memory. -<p> - -<pre> for ( int j = 0; j < numRows; ++j ) - <a name="x2445"></a> table.<a href="#setItem">setItem</a>( j, 1, new <a href="tqchecktableitem.html">TQCheckTableItem</a>( &table, "Check me" ) ); -</pre>In the example above we create a column of TQCheckTableItems and -insert them into the table using setItem(). -<p> TQTable takes ownership of its TQTableItems and will delete them -when the table itself is destroyed. You can take ownership of a -table item using <a href="#takeItem">takeItem</a>() 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, <a href="#swapCells">swapCells</a>()). -<p> In-place editing of the text in TQTableItems, and the values in -TQComboTableItems and TQCheckTableItems works automatically. Cells -may be editable or read-only, see <a href="qtableitem.html#wheneditable">TQTableItem::EditType</a>. If you -want fine control over editing see <a href="#beginEdit">beginEdit</a>() and <a href="#endEdit">endEdit</a>(). -<p> The contents of a cell can be retrieved as a <a href="qtableitem.html">TQTableItem</a> using -<a href="#item">item</a>(), or as a string with <a href="#text">text</a>() or as a pixmap (if there is -one) with <a href="#pixmap">pixmap</a>(). A cell's bounding rectangle is given by -<a href="#cellGeometry">cellGeometry</a>(). Use <a href="#updateCell">updateCell</a>() to repaint a cell, for example to -clear away a cell's visual representation after it has been -deleted with <a href="#clearCell">clearCell</a>(). The table can be forced to scroll to -show a particular cell with <a href="#ensureCellVisible">ensureCellVisible</a>(). The <a href="#isSelected">isSelected</a>() -function indicates if a cell is selected. -<p> It is possible to use your own widget as a cell's widget using -<a href="#setCellWidget">setCellWidget</a>(), but subclassing TQTableItem might be a simpler -approach. The cell's widget (if there is one) can be removed with -<a href="#clearCellWidget">clearCellWidget</a>(). -<p> <!-- index notes on large tables --><a name="notes-on-large-tables"></a><a name="bigtables"></a> -<h4> Large tables -</h4> -<a name="1-2-1"></a><p> For large, sparse, tables using TQTableItems or other widgets is -inefficient. The solution is to <em>draw</em> the cell as it should -appear and to create and destroy cell editors on demand. -<p> This approach requires that you reimplement various functions. -Reimplement <a href="#paintCell">paintCell</a>() to display your data, and <a href="#createEditor">createEditor</a>() -and <a href="#setCellContentFromEditor">setCellContentFromEditor</a>() to support in-place editing. It -is very important to reimplement <a href="#resizeData">resizeData</a>() to have no -functionality, to prevent TQTable from attempting to create a huge -array. You will also need to reimplement <a href="#item">item</a>(), <a href="#setItem">setItem</a>(), -<a href="#takeItem">takeItem</a>(), <a href="#clearCell">clearCell</a>(), and <a href="#insertWidget">insertWidget</a>(), <a href="#cellWidget">cellWidget</a>() and -<a href="#clearCellWidget">clearCellWidget</a>(). In almost every circumstance (for sorting, -removing and inserting columns and rows, etc.), you also need -to reimplement <a href="#swapRows">swapRows</a>(), <a href="#swapCells">swapCells</a>() and <a href="#swapColumns">swapColumns</a>(), including -header handling. -<p> If you represent active cells with a dictionary of TQTableItems and -TQWidgets, i.e. only store references to cells that are actually -used, many of the functions can be implemented with a single line -of code. (See the <a href="table-bigtable-main-cpp.html">table/bigtable/main.cpp</a> example.) -<p> For more information on cells see the <a href="qtableitem.html">TQTableItem</a> documenation. -<p> <a name="selections"></a> -<h3> Selections -</h3> -<a name="1-3"></a><p> TQTable's support single selection, multi-selection (multiple -cells) or no selection. The selection mode is set with -<a href="#setSelectionMode">setSelectionMode</a>(). Use <a href="#isSelected">isSelected</a>() to determine if a particular -cell is selected, and <a href="#isRowSelected">isRowSelected</a>() and <a href="#isColumnSelected">isColumnSelected</a>() to -see if a row or column is selected. -<p> TQTable's support many simultaneous selections. You can -programmatically select cells with <a href="#addSelection">addSelection</a>(). The number of -selections is given by <a href="#numSelections">numSelections</a>(). The current selection is -returned by <a href="#currentSelection">currentSelection</a>(). You can remove a selection with -<a href="#removeSelection">removeSelection</a>() and remove all selections with -<a href="#clearSelection">clearSelection</a>(). Selections are <a href="qtableselection.html">TQTableSelection</a> objects. -<p> To easily add a new selection use <a href="#selectCells">selectCells</a>(), <a href="#selectRow">selectRow</a>() or -<a href="#selectColumn">selectColumn</a>(). -<p> Alternatively, use addSelection() to add new selections using -TQTableSelection objects. The advantage of using TQTableSelection -objects is that you can call <a href="qtableselection.html#expandTo">TQTableSelection::expandTo</a>() to resize -the selection and can query and compare them. -<p> The number of selections is given by numSelections(). The current -selection is returned by currentSelection(). You can remove a -selection with removeSelection() and remove all selections with -clearSelection(). -<p> <a name="signals"></a> -<h3> Signals -</h3> -<a name="1-4"></a><p> When the user clicks a cell the <a href="#currentChanged">currentChanged</a>() signal is -emitted. You can also connect to the lower level <a href="#clicked">clicked</a>(), -<a href="#doubleClicked">doubleClicked</a>() and <a href="#pressed">pressed</a>() signals. If the user changes the -selection the <a href="#selectionChanged">selectionChanged</a>() signal is emitted; similarly if -the user changes a cell's value the <a href="#valueChanged">valueChanged</a>() signal is -emitted. If the user right-clicks (or presses the appropriate -platform-specific key sequence) the <a href="#contextMenuRequested">contextMenuRequested</a>() signal -is emitted. If the user drops a drag and drop object the <a href="#dropped">dropped</a>() -signal is emitted with the drop event. -<p>See also <a href="advanced.html">Advanced Widgets</a>. - -<hr><h2>Member Type Documentation</h2> -<h3 class=fn><a name="EditMode-enum"></a>TQTable::EditMode</h3> - -<ul> -<li><tt>TQTable::NotEditing</tt> - No cell is currently being edited. -<li><tt>TQTable::Editing</tt> - A cell is currently being edited. The editor was -initialised with the cell's contents. -<li><tt>TQTable::Replacing</tt> - A cell is currently being edited. The editor was -not initialised with the cell's contents. -</ul> -<h3 class=fn><a name="FocusStyle-enum"></a>TQTable::FocusStyle</h3> - -<p> Specifies how the current cell (focus cell) is drawn. -<ul> -<li><tt>TQTable::FollowStyle</tt> - The current cell is drawn according to the -current style and the cell's background is also drawn selected, if -the current cell is within a selection -<li><tt>TQTable::SpreadSheet</tt> - The current cell is drawn as in a spreadsheet. -This means, it is signified by a black rectangle around the cell, -and the background of the current cell is always drawn with the -widget's base color - even when selected. -</ul><p> -<h3 class=fn><a name="SelectionMode-enum"></a>TQTable::SelectionMode</h3> - -<ul> -<li><tt>TQTable::NoSelection</tt> - No cell can be selected by the user. -<li><tt>TQTable::Single</tt> - The user may only select a single range of cells. -<li><tt>TQTable::Multi</tt> - The user may select multiple ranges of cells. -<li><tt>TQTable::SingleRow</tt> - The user may select one row at once. -<li><tt>TQTable::MultiRow</tt> - The user may select multiple rows. -</ul> -<hr><h2>Member Function Documentation</h2> -<h3 class=fn><a name="TQTable"></a>TQTable::TQTable ( <a href="tqwidget.html">TQWidget</a> * parent = 0, const char * name = 0 ) -</h3> -Creates an empty table object called <em>name</em> as a child of <em>parent</em>. -<p> Call <a href="#setNumRows">setNumRows</a>() and <a href="#setNumCols">setNumCols</a>() to set the table size before -populating the table if you're using TQTableItems. -<p> <p>See also <a href="tqwidget.html#clearWFlags">TQWidget::clearWFlags</a>() and <a href="ntqt.html#WidgetFlags-enum">TQt::WidgetFlags</a>. - -<h3 class=fn><a name="TQTable-2"></a>TQTable::TQTable ( int numRows, int numCols, <a href="tqwidget.html">TQWidget</a> * parent = 0, const char * name = 0 ) -</h3> -Constructs an empty table called <em>name</em> with <em>numRows</em> rows and -<em>numCols</em> columns. The table is a child of <em>parent</em>. -<p> If you're using <a href="qtableitem.html">TQTableItem</a>s to populate the table's cells, you -can create <a href="qtableitem.html">TQTableItem</a>, <a href="tqcombotableitem.html">TQComboTableItem</a> and <a href="tqchecktableitem.html">TQCheckTableItem</a> items -and insert them into the table using <a href="#setItem">setItem</a>(). (See the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a> for an alternative to using TQTableItems.) -<p> <p>See also <a href="tqwidget.html#clearWFlags">TQWidget::clearWFlags</a>() and <a href="ntqt.html#WidgetFlags-enum">TQt::WidgetFlags</a>. - -<h3 class=fn><a name="~TQTable"></a>TQTable::~TQTable () -</h3> -Releases all the resources used by the TQTable object, -including all <a href="qtableitem.html">TQTableItem</a>s and their widgets. - -<h3 class=fn>void <a name="activateNextCell"></a>TQTable::activateNextCell ()<tt> [virtual protected]</tt> -</h3> -This function is called to activate the next cell if in-place -editing was finished by pressing the Enter key. -<p> The default behaviour is to move from top to bottom, i.e. move to -the cell beneath the cell being edited. Reimplement this function -if you want different behaviour, e.g. moving from left to right. - -<h3 class=fn>int <a name="addSelection"></a>TQTable::addSelection ( const <a href="qtableselection.html">TQTableSelection</a> & s )<tt> [virtual]</tt> -</h3> -Adds a selection described by <em>s</em> to the table and returns its -number or -1 if the selection is invalid. -<p> Remember to call <a href="qtableselection.html#init">TQTableSelection::init</a>() and -<a href="qtableselection.html#expandTo">TQTableSelection::expandTo</a>() to make the selection valid (see also -<a href="qtableselection.html#isActive">TQTableSelection::isActive</a>(), or use the -<a href="qtableselection.html">TQTableSelection</a>(int,int,int,int) constructor). -<p> <p>See also <a href="#numSelections-prop">numSelections</a>, <a href="#removeSelection">removeSelection</a>(), and <a href="#clearSelection">clearSelection</a>(). - -<h3 class=fn>void <a name="adjustColumn"></a>TQTable::adjustColumn ( int col )<tt> [virtual slot]</tt> -</h3> -Resizes column <em>col</em> so that the column width is wide enough to -display the widest item the column contains. -<p> <p>See also <a href="#adjustRow">adjustRow</a>(). - -<p>Example: <a href="regexptester-example.html#x2498">regexptester/regexptester.cpp</a>. -<p>Reimplemented in <a href="tqdatatable.html#adjustColumn">TQDataTable</a>. -<h3 class=fn>void <a name="adjustRow"></a>TQTable::adjustRow ( int row )<tt> [virtual slot]</tt> -</h3> -Resizes row <em>row</em> so that the row height is tall enough to -display the tallest item the row contains. -<p> <p>See also <a href="#adjustColumn">adjustColumn</a>(). - -<h3 class=fn><a href="tqwidget.html">TQWidget</a> * <a name="beginEdit"></a>TQTable::beginEdit ( int row, int col, bool replace )<tt> [virtual protected]</tt> -</h3> -This function is called to start in-place editing of the cell at -<em>row</em>, <em>col</em>. Editing is achieved by creating an editor -(<a href="#createEditor">createEditor</a>() is called) and setting the cell's editor with -<a href="#setCellWidget">setCellWidget</a>() to the newly created editor. (After editing is -complete <a href="#endEdit">endEdit</a>() will be called to replace the cell's content -with the editor's content.) If <em>replace</em> is TRUE the editor will -start empty; otherwise it will be initialized with the cell's -content (if any), i.e. the user will be modifying the original -cell content. -<p> <p>See also <a href="#endEdit">endEdit</a>(). - -<h3 class=fn><a href="tqrect.html">TQRect</a> <a name="cellGeometry"></a>TQTable::cellGeometry ( int row, int col ) const<tt> [virtual]</tt> -</h3> -Returns the bounding rectangle of the cell at <em>row</em>, <em>col</em> in -content coordinates. - -<h3 class=fn><a href="tqrect.html">TQRect</a> <a name="cellRect"></a>TQTable::cellRect ( int row, int col ) const<tt> [virtual]</tt> -</h3> -Returns the geometry of cell <em>row</em>, <em>col</em> in the cell's -coordinate system. This is a convenience function useful in -<a href="#paintCell">paintCell</a>(). It is equivalent to <a href="tqrect.html">TQRect</a>( <a href="tqpoint.html">TQPoint</a>(0,0), <a href="#cellGeometry">cellGeometry</a>( -row, col).<a href="tqwidget.html#size">size</a>() ); -<p> <p>See also <a href="#cellGeometry">cellGeometry</a>(). - -<p>Example: <a href="tutorial2-08.html#x2610">chart/setdataform.cpp</a>. -<h3 class=fn><a href="tqwidget.html">TQWidget</a> * <a name="cellWidget"></a>TQTable::cellWidget ( int row, int col ) const<tt> [virtual]</tt> -</h3> -Returns the widget that has been set for the cell at <em>row</em>, <em>col</em>, or 0 if no widget has been set. -<p> If you don't use <a href="qtableitem.html">TQTableItem</a>s you may need to reimplement this -function: see the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>. -<p> <p>See also <a href="#clearCellWidget">clearCellWidget</a>() and <a href="#setCellWidget">setCellWidget</a>(). - -<p>Example: <a href="tutorial2-08.html#x2611">chart/setdataform.cpp</a>. -<h3 class=fn>void <a name="clearCell"></a>TQTable::clearCell ( int row, int col )<tt> [virtual]</tt> -</h3> -Removes the <a href="qtableitem.html">TQTableItem</a> at <em>row</em>, <em>col</em>. -<p> If you don't use <a href="qtableitem.html">TQTableItem</a>s you may need to reimplement this -function: see the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>. - -<h3 class=fn>void <a name="clearCellWidget"></a>TQTable::clearCellWidget ( int row, int col )<tt> [virtual]</tt> -</h3> -Removes the widget (if there is one) set for the cell at <em>row</em>, -<em>col</em>. -<p> If you don't use <a href="qtableitem.html">TQTableItem</a>s you may need to reimplement this -function: see the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>. -<p> This function deletes the widget at <em>row</em>, <em>col</em>. Note that the -widget is not deleted immediately; instead <a href="tqobject.html#deleteLater">TQObject::deleteLater</a>() -is called on the widget to avoid problems with timing issues. -<p> <p>See also <a href="#cellWidget">cellWidget</a>() and <a href="#setCellWidget">setCellWidget</a>(). - -<h3 class=fn>void <a name="clearSelection"></a>TQTable::clearSelection ( bool repaint = TRUE )<tt> [slot]</tt> -</h3> -Clears all selections and repaints the appropriate regions if <em>repaint</em> is TRUE. -<p> <p>See also <a href="#removeSelection">removeSelection</a>(). - -<h3 class=fn>void <a name="clicked"></a>TQTable::clicked ( int row, int col, int button, const <a href="tqpoint.html">TQPoint</a> & mousePos )<tt> [signal]</tt> -</h3> - -<p> This signal is emitted when mouse button <em>button</em> is clicked. The -cell where the event took place is at <em>row</em>, <em>col</em>, and the -mouse's position is in <em>mousePos</em>. -<p> <p>See also <a href="ntqt.html#ButtonState-enum">TQt::ButtonState</a>. - -<p>Example: <a href="tutorial2-08.html#x2612">chart/setdataform.cpp</a>. -<h3 class=fn>int <a name="columnAt"></a>TQTable::columnAt ( int x ) const<tt> [virtual]</tt> -</h3> -Returns the number of the column at position <em>x</em>. <em>x</em> must be -given in content coordinates. -<p> <p>See also <a href="#columnPos">columnPos</a>() and <a href="#rowAt">rowAt</a>(). - -<h3 class=fn>void <a name="columnClicked"></a>TQTable::columnClicked ( int col )<tt> [virtual protected slot]</tt> -</h3> -This function is called when the column <em>col</em> has been clicked. -The default implementation sorts this column if <a href="#sorting">sorting</a>() is TRUE. - -<h3 class=fn>void <a name="columnIndexChanged"></a>TQTable::columnIndexChanged ( int section, int fromIndex, int toIndex )<tt> [virtual protected slot]</tt> -</h3> -This function is called when column order is to be changed, i.e. -when the user moved the column header <em>section</em> from <em>fromIndex</em> -to <em>toIndex</em>. -<p> If you want to change the column order programmatically, call -<a href="#swapRows">swapRows</a>() or <a href="#swapColumns">swapColumns</a>(); -<p> <p>See also <a href="ntqheader.html#indexChange">TQHeader::indexChange</a>() and <a href="#rowIndexChanged">rowIndexChanged</a>(). - -<h3 class=fn>bool <a name="columnMovingEnabled"></a>TQTable::columnMovingEnabled () const -</h3><p>Returns TRUE if columns can be moved by the user; otherwise returns FALSE. -See the <a href="ntqtable.html#columnMovingEnabled-prop">"columnMovingEnabled"</a> property for details. -<h3 class=fn>int <a name="columnPos"></a>TQTable::columnPos ( int col ) const<tt> [virtual]</tt> -</h3> -Returns the x-coordinate of the column <em>col</em> in content -coordinates. -<p> <p>See also <a href="#columnAt">columnAt</a>() and <a href="#rowPos">rowPos</a>(). - -<h3 class=fn>int <a name="columnWidth"></a>TQTable::columnWidth ( int col ) const<tt> [virtual]</tt> -</h3> -Returns the width of column <em>col</em>. -<p> <p>See also <a href="#setColumnWidth">setColumnWidth</a>() and <a href="#rowHeight">rowHeight</a>(). - -<h3 class=fn>void <a name="columnWidthChanged"></a>TQTable::columnWidthChanged ( int col )<tt> [virtual protected slot]</tt> -</h3> -This function should be called whenever the column width of <em>col</em> -has been changed. It updates the geometry of any affected columns -and repaints the table to reflect the changes it has made. - -<h3 class=fn>void <a name="contentsDragEnterEvent"></a>TQTable::contentsDragEnterEvent ( <a href="tqdragenterevent.html">TQDragEnterEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler is called whenever a TQTable object receives a -<a href="tqdragenterevent.html">TQDragEnterEvent</a> <em>e</em>, i.e. when the user pressed the mouse -button to drag something. -<p> The focus is moved to the cell where the <a href="tqdragenterevent.html">TQDragEnterEvent</a> occurred. - -<p>Reimplemented from <a href="tqscrollview.html#contentsDragEnterEvent">TQScrollView</a>. -<h3 class=fn>void <a name="contentsDragLeaveEvent"></a>TQTable::contentsDragLeaveEvent ( <a href="tqdragleaveevent.html">TQDragLeaveEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler is called when a drag activity leaves <em>this</em> -TQTable object with event <em>e</em>. - -<p>Reimplemented from <a href="tqscrollview.html#contentsDragLeaveEvent">TQScrollView</a>. -<h3 class=fn>void <a name="contentsDragMoveEvent"></a>TQTable::contentsDragMoveEvent ( <a href="tqdragmoveevent.html">TQDragMoveEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler is called whenever a TQTable object receives a -<a href="tqdragmoveevent.html">TQDragMoveEvent</a> <em>e</em>, i.e. when the user actually drags the -mouse. -<p> The focus is moved to the cell where the <a href="tqdragmoveevent.html">TQDragMoveEvent</a> occurred. - -<p>Reimplemented from <a href="tqscrollview.html#contentsDragMoveEvent">TQScrollView</a>. -<h3 class=fn>void <a name="contentsDropEvent"></a>TQTable::contentsDropEvent ( <a href="tqdropevent.html">TQDropEvent</a> * e )<tt> [virtual protected]</tt> -</h3> -This event handler is called when the user ends a drag and drop by -dropping something onto <em>this</em> TQTable and thus triggers the drop -event, <em>e</em>. - -<p>Reimplemented from <a href="tqscrollview.html#contentsDropEvent">TQScrollView</a>. -<h3 class=fn>void <a name="contextMenuRequested"></a>TQTable::contextMenuRequested ( int row, int col, const <a href="tqpoint.html">TQPoint</a> & pos )<tt> [signal]</tt> -</h3> - -<p> This signal is emitted when the user invokes a context menu with -the right mouse button (or with a system-specific keypress). The -cell where the event took place is at <em>row</em>, <em>col</em>. <em>pos</em> is -the position where the context menu will appear in the global -coordinate system. This signal is always emitted, even if the -contents of the cell are disabled. - -<h3 class=fn><a href="tqwidget.html">TQWidget</a> * <a name="createEditor"></a>TQTable::createEditor ( int row, int col, bool initFromCell ) const<tt> [virtual protected]</tt> -</h3> -This function returns the widget which should be used as an editor -for the contents of the cell at <em>row</em>, <em>col</em>. -<p> If <em>initFromCell</em> is TRUE, the editor is used to edit the current -contents of the cell (so the editor widget should be initialized -with this content). If <em>initFromCell</em> is FALSE, the content of -the cell is replaced with the new content which the user entered -into the widget created by this function. -<p> The default functionality is as follows: if <em>initFromCell</em> is -TRUE or the cell has a <a href="qtableitem.html">TQTableItem</a> and the table item's -<a href="qtableitem.html#isReplaceable">TQTableItem::isReplaceable</a>() is FALSE then the cell is asked to -create an appropriate editor (using <a href="qtableitem.html#createEditor">TQTableItem::createEditor</a>()). -Otherwise a <a href="tqlineedit.html">TQLineEdit</a> is used as the editor. -<p> If you want to create your own editor for certain cells, implement -a custom TQTableItem subclass and reimplement -TQTableItem::createEditor(). -<p> If you are not using <a href="qtableitem.html">TQTableItem</a>s and you don't want to use a -TQLineEdit as the default editor, subclass TQTable and reimplement -this function with code like this: -<pre> - <a href="qtableitem.html">TQTableItem</a> *i = <a href="#item">item</a>( row, col ); - if ( initFromCell || ( i && !i-><a href="qtableitem.html#isReplaceable">isReplaceable</a>() ) ) - // If we had a TQTableItem ask the base class to create the editor - return TQTable::createEditor( row, col, initFromCell ); - else - return ...(create your own editor) - </pre> - -Ownership of the editor widget is transferred to the caller. -<p> If you reimplement this function return 0 for read-only cells. You -will need to reimplement <a href="#setCellContentFromEditor">setCellContentFromEditor</a>() to retrieve -the data the user entered. -<p> <p>See also <a href="qtableitem.html#createEditor">TQTableItem::createEditor</a>(). - -<h3 class=fn>int <a name="currEditCol"></a>TQTable::currEditCol () const<tt> [protected]</tt> -</h3> -Returns the current edited column - -<h3 class=fn>int <a name="currEditRow"></a>TQTable::currEditRow () const<tt> [protected]</tt> -</h3> -Returns the current edited row - -<h3 class=fn>void <a name="currentChanged"></a>TQTable::currentChanged ( int row, int col )<tt> [signal]</tt> -</h3> - -<p> This signal is emitted when the current cell has changed to <em>row</em>, <em>col</em>. - -<p>Example: <a href="tutorial2-08.html#x2613">chart/setdataform.cpp</a>. -<h3 class=fn>int <a name="currentColumn"></a>TQTable::currentColumn () const -</h3> - -<p> Returns the current column. -<p> <p>See also <a href="#currentRow">currentRow</a>(). - -<p>Example: <a href="tutorial2-08.html#x2614">chart/setdataform.cpp</a>. -<h3 class=fn>int <a name="currentRow"></a>TQTable::currentRow () const -</h3> - -<p> Returns the current row. -<p> <p>See also <a href="#currentColumn">currentColumn</a>(). - -<p>Example: <a href="tutorial2-08.html#x2615">chart/setdataform.cpp</a>. -<h3 class=fn>int <a name="currentSelection"></a>TQTable::currentSelection () const<tt> [virtual]</tt> -</h3> -Returns the number of the current selection or -1 if there is no -current selection. -<p> <p>See also <a href="#numSelections-prop">numSelections</a>. - -<h3 class=fn>void <a name="doubleClicked"></a>TQTable::doubleClicked ( int row, int col, int button, const <a href="tqpoint.html">TQPoint</a> & mousePos )<tt> [signal]</tt> -</h3> - -<p> This signal is emitted when mouse button <em>button</em> is -double-clicked. The cell where the event took place is at <em>row</em>, -<em>col</em>, and the mouse's position is in <em>mousePos</em>. -<p> <p>See also <a href="ntqt.html#ButtonState-enum">TQt::ButtonState</a>. - -<h3 class=fn>bool <a name="dragEnabled"></a>TQTable::dragEnabled () const<tt> [slot]</tt> -</h3> -If this function returns TRUE, the table supports dragging. -<p> <p>See also <a href="#setDragEnabled">setDragEnabled</a>(). - -<h3 class=fn><a href="tqdragobject.html">TQDragObject</a> * <a name="dragObject"></a>TQTable::dragObject ()<tt> [virtual protected]</tt> -</h3> -If the user presses the mouse on a selected cell, starts moving -(i.e. dragging), and <a href="#dragEnabled">dragEnabled</a>() is TRUE, this function is -called to obtain a drag object. A drag using this object begins -immediately unless <a href="#dragObject">dragObject</a>() returns 0. -<p> By default this function returns 0. You might reimplement it and -create a <a href="tqdragobject.html">TQDragObject</a> depending on the selected items. -<p> <p>See also <a href="#dropped">dropped</a>(). - -<h3 class=fn>void <a name="drawContents"></a>TQTable::drawContents ( <a href="tqpainter.html">TQPainter</a> * p, int cx, int cy, int cw, int ch )<tt> [virtual protected]</tt> -</h3> -Draws the table contents on the painter <em>p</em>. This function is -optimized so that it only draws the cells inside the <em>cw</em> pixels -wide and <em>ch</em> pixels high clipping rectangle at position <em>cx</em>, -<em>cy</em>. -<p> Additionally, <a href="#drawContents">drawContents</a>() highlights the current cell. - -<p>Reimplemented from <a href="tqscrollview.html#drawContents">TQScrollView</a>. -<h3 class=fn>void <a name="dropped"></a>TQTable::dropped ( <a href="tqdropevent.html">TQDropEvent</a> * e )<tt> [signal]</tt> -</h3> - -<p> This signal is emitted when a drop event occurred on the table. -<p> <em>e</em> contains information about the drop. - -<h3 class=fn>void <a name="editCell"></a>TQTable::editCell ( int row, int col, bool replace = FALSE )<tt> [virtual slot]</tt> -</h3> -Starts editing the cell at <em>row</em>, <em>col</em>. -<p> If <em>replace</em> is TRUE the content of this cell will be replaced by -the content of the editor when editing is finished, i.e. the user -will be entering new data; otherwise the current content of the -cell (if any) will be modified in the editor. -<p> <p>See also <a href="#beginEdit">beginEdit</a>(). - -<h3 class=fn><a href="ntqtable.html#EditMode-enum">EditMode</a> <a name="editMode"></a>TQTable::editMode () const<tt> [protected]</tt> -</h3> -Returns the current edit mode -<p> <p>See also <a href="#EditMode-enum">TQTable::EditMode</a>. - -<h3 class=fn>void <a name="endEdit"></a>TQTable::endEdit ( int row, int col, bool accept, bool replace )<tt> [virtual protected]</tt> -</h3> -This function is called when in-place editing of the cell at <em>row</em>, <em>col</em> is requested to stop. -<p> If the cell is not being edited or <em>accept</em> is FALSE the function -returns and the cell's contents are left unchanged. -<p> If <em>accept</em> is TRUE the content of the editor must be transferred -to the relevant cell. If <em>replace</em> is TRUE the current content of -this cell should be replaced by the content of the editor (this -means removing the current <a href="qtableitem.html">TQTableItem</a> of the cell and creating a -new one for the cell). Otherwise (if possible) the content of the -editor should just be set to the existing TQTableItem of this cell. -<p> <a href="#setCellContentFromEditor">setCellContentFromEditor</a>() is called to replace the contents of -the cell with the contents of the cell's editor. -<p> Finally <a href="#clearCellWidget">clearCellWidget</a>() is called to remove the editor widget. -<p> <p>See also <a href="#setCellContentFromEditor">setCellContentFromEditor</a>() and <a href="#beginEdit">beginEdit</a>(). - -<h3 class=fn>void <a name="ensureCellVisible"></a>TQTable::ensureCellVisible ( int row, int col ) -</h3> -Scrolls the table until the cell at <em>row</em>, <em>col</em> becomes -visible. - -<h3 class=fn><a href="ntqtable.html#FocusStyle-enum">FocusStyle</a> <a name="focusStyle"></a>TQTable::focusStyle () const -</h3><p>Returns how the current (focus) cell is drawn. -See the <a href="ntqtable.html#focusStyle-prop">"focusStyle"</a> property for details. -<h3 class=fn>void <a name="hideColumn"></a>TQTable::hideColumn ( int col )<tt> [virtual slot]</tt> -</h3> -Hides column <em>col</em>. -<p> <p>See also <a href="#showColumn">showColumn</a>() and <a href="#hideRow">hideRow</a>(). - -<h3 class=fn>void <a name="hideRow"></a>TQTable::hideRow ( int row )<tt> [virtual slot]</tt> -</h3> -Hides row <em>row</em>. -<p> <p>See also <a href="#showRow">showRow</a>() and <a href="#hideColumn">hideColumn</a>(). - -<h3 class=fn><a href="ntqheader.html">TQHeader</a> * <a name="horizontalHeader"></a>TQTable::horizontalHeader () const -</h3> -Returns the table's top <a href="ntqheader.html">TQHeader</a>. -<p> This header contains the column labels. -<p> To modify a column label use <a href="ntqheader.html#setLabel">TQHeader::setLabel</a>(), e.g. - - -<pre> <a href="#horizontalHeader">horizontalHeader</a>()->setLabel( 0, tr( "File" ) ); -</pre> -<p> <p>See also <a href="#verticalHeader">verticalHeader</a>(), <a href="#setTopMargin">setTopMargin</a>(), and <a href="ntqheader.html">TQHeader</a>. - -<p>Examples: <a href="tutorial2-08.html#x2616">chart/setdataform.cpp</a>, <a href="helpsystem-example.html#x2690">helpsystem/mainwindow.cpp</a>, <a href="regexptester-example.html#x2499">regexptester/regexptester.cpp</a>, and <a href="small-table-example-example.html#x2800">table/small-table-demo/main.cpp</a>. -<h3 class=fn>int <a name="indexOf"></a>TQTable::indexOf ( int row, int col ) const<tt> [protected]</tt> -</h3> -Returns a single integer which identifies a particular <em>row</em> and <em>col</em> by mapping the 2D table to a 1D array. -<p> This is useful, for example, if you have a sparse table and want to -use a <a href="tqintdict.html">TQIntDict</a> to map integers to the cells that are used. - -<h3 class=fn>void <a name="insertColumns"></a>TQTable::insertColumns ( int col, int count = 1 )<tt> [virtual slot]</tt> -</h3> -Inserts <em>count</em> empty columns at column <em>col</em>. Also clears the <a href="#selection">selection</a>(s). -<p> <p>See also <a href="#insertRows">insertRows</a>() and <a href="#removeColumn">removeColumn</a>(). - -<h3 class=fn>void <a name="insertRows"></a>TQTable::insertRows ( int row, int count = 1 )<tt> [virtual slot]</tt> -</h3> -Inserts <em>count</em> empty rows at row <em>row</em>. Also clears the <a href="#selection">selection</a>(s). -<p> <p>See also <a href="#insertColumns">insertColumns</a>() and <a href="#removeRow">removeRow</a>(). - -<h3 class=fn>void <a name="insertWidget"></a>TQTable::insertWidget ( int row, int col, <a href="tqwidget.html">TQWidget</a> * w )<tt> [virtual protected]</tt> -</h3> -Inserts widget <em>w</em> at <em>row</em>, <em>col</em> into the internal -data structure. See the documentation of <a href="#setCellWidget">setCellWidget</a>() for -further details. -<p> If you don't use <a href="qtableitem.html">TQTableItem</a>s you may need to reimplement this -function: see the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>. - -<h3 class=fn>bool <a name="isColumnHidden"></a>TQTable::isColumnHidden ( int col ) const<tt> [slot]</tt> -</h3> -Returns TRUE if column <em>col</em> is hidden; otherwise returns -FALSE. -<p> <p>See also <a href="#hideColumn">hideColumn</a>() and <a href="#isRowHidden">isRowHidden</a>(). - -<h3 class=fn>bool <a name="isColumnReadOnly"></a>TQTable::isColumnReadOnly ( int col ) const -</h3> -Returns TRUE if column <em>col</em> is read-only; otherwise returns -FALSE. -<p> Whether a cell in this column is editable or read-only depends on -the cell's EditType, and this setting: see <a href="qtableitem.html#wheneditable">TQTableItem::EditType</a>. -<p> <p>See also <a href="#setColumnReadOnly">setColumnReadOnly</a>() and <a href="#isRowReadOnly">isRowReadOnly</a>(). - -<h3 class=fn>bool <a name="isColumnSelected"></a>TQTable::isColumnSelected ( int col, bool full = FALSE ) const -</h3> -Returns TRUE if column <em>col</em> is selected; otherwise returns FALSE. -<p> If <em>full</em> is FALSE (the default), 'column is selected' means that -at least one cell in the column is selected. If <em>full</em> is TRUE, -then 'column is selected' means every cell in the column is -selected. -<p> <p>See also <a href="#isRowSelected">isRowSelected</a>() and <a href="#isSelected">isSelected</a>(). - -<h3 class=fn>bool <a name="isColumnStretchable"></a>TQTable::isColumnStretchable ( int col ) const<tt> [slot]</tt> -</h3> -Returns TRUE if column <em>col</em> is stretchable; otherwise returns -FALSE. -<p> <p>See also <a href="#setColumnStretchable">setColumnStretchable</a>() and <a href="#isRowStretchable">isRowStretchable</a>(). - -<h3 class=fn>bool <a name="isEditing"></a>TQTable::isEditing () const<tt> [protected]</tt> -</h3> -Returns TRUE if the <a href="#EditMode-enum">EditMode</a> is <a href="#EditMode-enum">Editing</a> or <a href="#EditMode-enum">Replacing</a>; -otherwise (i.e. the <a href="#EditMode-enum">EditMode</a> is <a href="#EditMode-enum">NotEditing</a>) returns FALSE. -<p> <p>See also <a href="#EditMode-enum">TQTable::EditMode</a>. - -<h3 class=fn>bool <a name="isReadOnly"></a>TQTable::isReadOnly () const -</h3><p>Returns TRUE if the table is read-only; otherwise returns FALSE. -See the <a href="ntqtable.html#readOnly-prop">"readOnly"</a> property for details. -<h3 class=fn>bool <a name="isRowHidden"></a>TQTable::isRowHidden ( int row ) const<tt> [slot]</tt> -</h3> -Returns TRUE if row <em>row</em> is hidden; otherwise returns -FALSE. -<p> <p>See also <a href="#hideRow">hideRow</a>() and <a href="#isColumnHidden">isColumnHidden</a>(). - -<h3 class=fn>bool <a name="isRowReadOnly"></a>TQTable::isRowReadOnly ( int row ) const -</h3> -Returns TRUE if row <em>row</em> is read-only; otherwise returns FALSE. -<p> Whether a cell in this row is editable or read-only depends on the -cell's <a href="qtableitem.html#EditType-enum">EditType</a>, and this -setting: see <a href="qtableitem.html#wheneditable">TQTableItem::EditType</a>. -<p> <p>See also <a href="#setRowReadOnly">setRowReadOnly</a>() and <a href="#isColumnReadOnly">isColumnReadOnly</a>(). - -<h3 class=fn>bool <a name="isRowSelected"></a>TQTable::isRowSelected ( int row, bool full = FALSE ) const -</h3> -Returns TRUE if row <em>row</em> is selected; otherwise returns FALSE. -<p> If <em>full</em> is FALSE (the default), 'row is selected' means that at -least one cell in the row is selected. If <em>full</em> is TRUE, then 'row -is selected' means every cell in the row is selected. -<p> <p>See also <a href="#isColumnSelected">isColumnSelected</a>() and <a href="#isSelected">isSelected</a>(). - -<h3 class=fn>bool <a name="isRowStretchable"></a>TQTable::isRowStretchable ( int row ) const<tt> [slot]</tt> -</h3> -Returns TRUE if row <em>row</em> is stretchable; otherwise returns -FALSE. -<p> <p>See also <a href="#setRowStretchable">setRowStretchable</a>() and <a href="#isColumnStretchable">isColumnStretchable</a>(). - -<h3 class=fn>bool <a name="isSelected"></a>TQTable::isSelected ( int row, int col ) const -</h3> -Returns TRUE if the cell at <em>row</em>, <em>col</em> is selected; otherwise -returns FALSE. -<p> <p>See also <a href="#isRowSelected">isRowSelected</a>() and <a href="#isColumnSelected">isColumnSelected</a>(). - -<h3 class=fn><a href="qtableitem.html">TQTableItem</a> * <a name="item"></a>TQTable::item ( int row, int col ) const<tt> [virtual]</tt> -</h3> -Returns the <a href="qtableitem.html">TQTableItem</a> representing the contents of the cell at <em>row</em>, <em>col</em>. -<p> If <em>row</em> or <em>col</em> are out of range or no content has been set -for this cell, <a href="#item">item</a>() returns 0. -<p> If you don't use <a href="qtableitem.html">TQTableItem</a>s you may need to reimplement this -function: see the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>. -<p> <p>See also <a href="#setItem">setItem</a>(). - -<p>Example: <a href="regexptester-example.html#x2500">regexptester/regexptester.cpp</a>. -<h3 class=fn>int <a name="numCols"></a>TQTable::numCols () const<tt> [virtual]</tt> -</h3><p>Returns the number of columns in the table. -See the <a href="ntqtable.html#numCols-prop">"numCols"</a> property for details. -<p>Reimplemented in <a href="tqdatatable.html#numCols">TQDataTable</a>. -<h3 class=fn>int <a name="numRows"></a>TQTable::numRows () const<tt> [virtual]</tt> -</h3><p>Returns the number of rows in the table. -See the <a href="ntqtable.html#numRows-prop">"numRows"</a> property for details. -<p>Reimplemented in <a href="tqdatatable.html#numRows">TQDataTable</a>. -<h3 class=fn>int <a name="numSelections"></a>TQTable::numSelections () const -</h3><p>Returns the number of selections. -See the <a href="ntqtable.html#numSelections-prop">"numSelections"</a> property for details. -<h3 class=fn>void <a name="paintCell"></a>TQTable::paintCell ( <a href="tqpainter.html">TQPainter</a> * p, int row, int col, const <a href="tqrect.html">TQRect</a> & cr, bool selected, const <a href="tqcolorgroup.html">TQColorGroup</a> & cg )<tt> [virtual]</tt> -</h3> -Paints the cell at <em>row</em>, <em>col</em> on the painter <em>p</em>. The painter -has already been translated to the cell's origin. <em>cr</em> describes -the cell coordinates in the content coordinate system. -<p> If <em>selected</em> is TRUE the cell is highlighted. -<p> <em>cg</em> is the colorgroup which should be used to draw the cell -content. -<p> If you want to draw custom cell content, for example right-aligned -text, you must either reimplement <a href="#paintCell">paintCell</a>(), or subclass -<a href="qtableitem.html">TQTableItem</a> and reimplement <a href="qtableitem.html#paint">TQTableItem::paint</a>() to do the custom -drawing. -<p> If you're using a TQTableItem subclass, for example, to store a -data structure, then reimplementing TQTableItem::paint() may be the -best approach. For data you want to draw immediately, e.g. data -retrieved from a database, it is probably best to reimplement -paintCell(). Note that if you reimplement paintCell(), i.e. don't -use <a href="qtableitem.html">TQTableItem</a>s, you must reimplement other functions: see the -<a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>. -<p> Note that the painter is not clipped by default in order to get -maximum efficiency. If you want clipping, use code like this: -<p> <pre> - p->setClipRect( <a href="#cellRect">cellRect</a>(row, col), TQPainter::CoordPainter ); - //... your drawing code - p->setClipping( FALSE ); - </pre> - - -<h3 class=fn>void <a name="paintCell-2"></a>TQTable::paintCell ( <a href="tqpainter.html">TQPainter</a> * p, int row, int col, const <a href="tqrect.html">TQRect</a> & cr, bool selected )<tt> [virtual]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Use the other <a href="#paintCell">paintCell</a>() function. This function is only included -for backwards compatibilty. - -<h3 class=fn>void <a name="paintEmptyArea"></a>TQTable::paintEmptyArea ( <a href="tqpainter.html">TQPainter</a> * p, int cx, int cy, int cw, int ch )<tt> [virtual protected]</tt> -</h3> -This function fills the <em>cw</em> pixels wide and <em>ch</em> pixels high -rectangle starting at position <em>cx</em>, <em>cy</em> with the background -color using the painter <em>p</em>. -<p> <a href="#paintEmptyArea">paintEmptyArea</a>() is invoked by <a href="#drawContents">drawContents</a>() to erase or fill -unused areas. - -<h3 class=fn>void <a name="paintFocus"></a>TQTable::paintFocus ( <a href="tqpainter.html">TQPainter</a> * p, const <a href="tqrect.html">TQRect</a> & cr )<tt> [virtual]</tt> -</h3> -Draws the focus rectangle of the current cell (see <a href="#currentRow">currentRow</a>(), -<a href="#currentColumn">currentColumn</a>()). -<p> The painter <em>p</em> is already translated to the cell's origin, while -<em>cr</em> specifies the cell's geometry in content coordinates. - -<h3 class=fn><a href="tqpixmap.html">TQPixmap</a> <a name="pixmap"></a>TQTable::pixmap ( int row, int col ) const<tt> [virtual]</tt> -</h3> -Returns the pixmap set for the cell at <em>row</em>, <em>col</em>, or a -null-pixmap if the cell contains no pixmap. -<p> <p>See also <a href="#setPixmap">setPixmap</a>(). - -<p>Example: <a href="tutorial2-08.html#x2617">chart/setdataform.cpp</a>. -<h3 class=fn>void <a name="pressed"></a>TQTable::pressed ( int row, int col, int button, const <a href="tqpoint.html">TQPoint</a> & mousePos )<tt> [signal]</tt> -</h3> - -<p> This signal is emitted when mouse button <em>button</em> is pressed. The -cell where the event took place is at <em>row</em>, <em>col</em>, and the -mouse's position is in <em>mousePos</em>. -<p> <p>See also <a href="ntqt.html#ButtonState-enum">TQt::ButtonState</a>. - -<h3 class=fn>void <a name="removeColumn"></a>TQTable::removeColumn ( int col )<tt> [virtual slot]</tt> -</h3> -Removes column <em>col</em>, and deletes all its cells including any -table items and widgets the cells may contain. Also clears the -<a href="#selection">selection</a>(s). -<p> <p>See also <a href="#removeColumns">removeColumns</a>(), <a href="#hideColumn">hideColumn</a>(), <a href="#insertColumns">insertColumns</a>(), and <a href="#removeRow">removeRow</a>(). - -<h3 class=fn>void <a name="removeColumns"></a>TQTable::removeColumns ( const <a href="tqmemarray.html">TQMemArray</a><int> & cols )<tt> [virtual slot]</tt> -</h3> -Removes the columns listed in the array <em>cols</em>, and deletes all -their cells including any table items and widgets the cells may -contain. -<p> The array passed in must only contain valid columns (in the range -from 0 to <a href="#numCols">numCols</a>() - 1) with no duplicates, and must be sorted in -ascending order. Also clears the <a href="#selection">selection</a>(s). -<p> <p>See also <a href="#removeColumn">removeColumn</a>(), <a href="#insertColumns">insertColumns</a>(), and <a href="#removeRows">removeRows</a>(). - -<h3 class=fn>void <a name="removeRow"></a>TQTable::removeRow ( int row )<tt> [virtual slot]</tt> -</h3> -Removes row <em>row</em>, and deletes all its cells including any table -items and widgets the cells may contain. Also clears the <a href="#selection">selection</a>(s). -<p> <p>See also <a href="#hideRow">hideRow</a>(), <a href="#insertRows">insertRows</a>(), <a href="#removeColumn">removeColumn</a>(), and <a href="#removeRows">removeRows</a>(). - -<h3 class=fn>void <a name="removeRows"></a>TQTable::removeRows ( const <a href="tqmemarray.html">TQMemArray</a><int> & rows )<tt> [virtual slot]</tt> -</h3> -Removes the rows listed in the array <em>rows</em>, and deletes all their -cells including any table items and widgets the cells may contain. -<p> The array passed in must only contain valid rows (in the range -from 0 to <a href="#numRows">numRows</a>() - 1) with no duplicates, and must be sorted in -ascending order. Also clears the <a href="#selection">selection</a>(s). -<p> <p>See also <a href="#removeRow">removeRow</a>(), <a href="#insertRows">insertRows</a>(), and <a href="#removeColumns">removeColumns</a>(). - -<h3 class=fn>void <a name="removeSelection"></a>TQTable::removeSelection ( const <a href="qtableselection.html">TQTableSelection</a> & s )<tt> [virtual]</tt> -</h3> -If the table has a selection, <em>s</em>, this selection is removed from -the table. -<p> <p>See also <a href="#addSelection">addSelection</a>() and <a href="#numSelections-prop">numSelections</a>. - -<h3 class=fn>void <a name="removeSelection-2"></a>TQTable::removeSelection ( int num )<tt> [virtual]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Removes selection number <em>num</em> from the table. -<p> <p>See also <a href="#numSelections-prop">numSelections</a>, <a href="#addSelection">addSelection</a>(), and <a href="#clearSelection">clearSelection</a>(). - -<h3 class=fn>void <a name="repaintSelections"></a>TQTable::repaintSelections () -</h3> -Repaints all selections - -<h3 class=fn>void <a name="resizeData"></a>TQTable::resizeData ( int len )<tt> [virtual protected]</tt> -</h3> -This is called when TQTable's internal array needs to be resized to -<em>len</em> elements. -<p> If you don't use TQTableItems you should reimplement this as an -empty method to avoid wasting memory. See the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a> for further details. - -<h3 class=fn>int <a name="rowAt"></a>TQTable::rowAt ( int y ) const<tt> [virtual]</tt> -</h3> -Returns the number of the row at position <em>y</em>. <em>y</em> must be given -in content coordinates. -<p> <p>See also <a href="#rowPos">rowPos</a>() and <a href="#columnAt">columnAt</a>(). - -<h3 class=fn>int <a name="rowHeight"></a>TQTable::rowHeight ( int row ) const<tt> [virtual]</tt> -</h3> -Returns the height of row <em>row</em>. -<p> <p>See also <a href="#setRowHeight">setRowHeight</a>() and <a href="#columnWidth">columnWidth</a>(). - -<p>Example: <a href="small-table-example-example.html#x2801">table/small-table-demo/main.cpp</a>. -<h3 class=fn>void <a name="rowHeightChanged"></a>TQTable::rowHeightChanged ( int row )<tt> [virtual protected slot]</tt> -</h3> -This function should be called whenever the row height of <em>row</em> -has been changed. It updates the geometry of any affected rows and -repaints the table to reflect the changes it has made. - -<h3 class=fn>void <a name="rowIndexChanged"></a>TQTable::rowIndexChanged ( int section, int fromIndex, int toIndex )<tt> [virtual protected slot]</tt> -</h3> -This function is called when the order of the rows is to be -changed, i.e. the user moved the row header section <em>section</em> -from <em>fromIndex</em> to <em>toIndex</em>. -<p> If you want to change the order programmatically, call <a href="#swapRows">swapRows</a>() -or <a href="#swapColumns">swapColumns</a>(); -<p> <p>See also <a href="ntqheader.html#indexChange">TQHeader::indexChange</a>() and <a href="#columnIndexChanged">columnIndexChanged</a>(). - -<h3 class=fn>bool <a name="rowMovingEnabled"></a>TQTable::rowMovingEnabled () const -</h3><p>Returns TRUE if rows can be moved by the user; otherwise returns FALSE. -See the <a href="ntqtable.html#rowMovingEnabled-prop">"rowMovingEnabled"</a> property for details. -<h3 class=fn>int <a name="rowPos"></a>TQTable::rowPos ( int row ) const<tt> [virtual]</tt> -</h3> -Returns the y-coordinate of the row <em>row</em> in content coordinates. -<p> <p>See also <a href="#rowAt">rowAt</a>() and <a href="#columnPos">columnPos</a>(). - -<h3 class=fn>void <a name="selectCells"></a>TQTable::selectCells ( int start_row, int start_col, int end_row, int end_col ) -</h3> Selects the range starting at <em>start_row</em> and <em>start_col</em> and -ending at <em>end_row</em> and <em>end_col</em>. -<p> <p>See also <a href="qtableselection.html">TQTableSelection</a>. - -<h3 class=fn>void <a name="selectColumn"></a>TQTable::selectColumn ( int col ) -</h3> Selects the column <em>col</em>. -<p> <p>See also <a href="qtableselection.html">TQTableSelection</a>. - -<h3 class=fn>void <a name="selectRow"></a>TQTable::selectRow ( int row ) -</h3> Selects the row <em>row</em>. -<p> <p>See also <a href="qtableselection.html">TQTableSelection</a>. - -<h3 class=fn><a href="qtableselection.html">TQTableSelection</a> <a name="selection"></a>TQTable::selection ( int num ) const -</h3> -Returns selection number <em>num</em>, or an inactive <a href="qtableselection.html">TQTableSelection</a> if <em>num</em> is out of range (see <a href="qtableselection.html#isActive">TQTableSelection::isActive</a>()). - -<h3 class=fn>void <a name="selectionChanged"></a>TQTable::selectionChanged ()<tt> [signal]</tt> -</h3> - -<p> This signal is emitted whenever a selection changes. -<p> <p>See also <a href="qtableselection.html">TQTableSelection</a>. - -<h3 class=fn><a href="ntqtable.html#SelectionMode-enum">SelectionMode</a> <a name="selectionMode"></a>TQTable::selectionMode () const -</h3><p>Returns the current selection mode. -See the <a href="ntqtable.html#selectionMode-prop">"selectionMode"</a> property for details. -<h3 class=fn>void <a name="setCellContentFromEditor"></a>TQTable::setCellContentFromEditor ( int row, int col )<tt> [virtual protected]</tt> -</h3> -This function is called to replace the contents of the cell at <em>row</em>, <em>col</em> with the contents of the cell's editor. -<p> If there already exists a <a href="qtableitem.html">TQTableItem</a> for the cell, -it calls <a href="qtableitem.html#setContentFromEditor">TQTableItem::setContentFromEditor</a>() on this TQTableItem. -<p> If, for example, you want to create different <a href="qtableitem.html">TQTableItem</a>s -depending on the contents of the editor, you might reimplement -this function. -<p> If you want to work without <a href="qtableitem.html">TQTableItem</a>s, you will need to -reimplement this function to save the data the user entered into -your data structure. (See the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>.) -<p> <p>See also <a href="qtableitem.html#setContentFromEditor">TQTableItem::setContentFromEditor</a>() and <a href="#createEditor">createEditor</a>(). - -<h3 class=fn>void <a name="setCellWidget"></a>TQTable::setCellWidget ( int row, int col, <a href="tqwidget.html">TQWidget</a> * e )<tt> [virtual]</tt> -</h3> -Sets the widget <em>e</em> to the cell at <em>row</em>, <em>col</em> and takes care of -placing and resizing the widget when the cell geometry changes. -<p> By default widgets are inserted into a vector with <a href="#numRows">numRows</a>() * -<a href="#numCols">numCols</a>() elements. In very large tables you will probably want to -store the widgets in a data structure that consumes less memory (see -the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>). To support the use of your own data -structure this function calls <a href="#insertWidget">insertWidget</a>() to add the widget to -the internal data structure. To use your own data structure -reimplement insertWidget(), <a href="#cellWidget">cellWidget</a>() and <a href="#clearCellWidget">clearCellWidget</a>(). -<p> Cell widgets are created dynamically with the <tt>new</tt> operator. The -cell widgets are destroyed automatically once the table is -destroyed; the table takes ownership of the widget when using -setCellWidget. -<p> -<p>Example: <a href="tutorial2-08.html#x2618">chart/setdataform.cpp</a>. -<h3 class=fn>void <a name="setColumnLabels"></a>TQTable::setColumnLabels ( const <a href="tqstringlist.html">TQStringList</a> & labels )<tt> [slot]</tt> -</h3> Sets the section labels of the <a href="#horizontalHeader">horizontalHeader</a>() to <em>labels</em> -<h3 class=fn>void <a name="setColumnMovingEnabled"></a>TQTable::setColumnMovingEnabled ( bool b )<tt> [virtual slot]</tt> -</h3><p>Sets whether columns can be moved by the user to <em>b</em>. -See the <a href="ntqtable.html#columnMovingEnabled-prop">"columnMovingEnabled"</a> property for details. -<h3 class=fn>void <a name="setColumnReadOnly"></a>TQTable::setColumnReadOnly ( int col, bool ro )<tt> [virtual slot]</tt> -</h3> -If <em>ro</em> is TRUE, column <em>col</em> is set to be read-only; otherwise -the column is set to be editable. -<p> Whether a cell in this column is editable or read-only depends on -the cell's EditType, and this setting: -see <a href="qtableitem.html#wheneditable">TQTableItem::EditType</a>. -<p> <p>See also <a href="#isColumnReadOnly">isColumnReadOnly</a>(), <a href="#setRowReadOnly">setRowReadOnly</a>(), and <a href="#readOnly-prop">readOnly</a>. - -<p> -<p>Example: <a href="tutorial2-08.html#x2619">chart/setdataform.cpp</a>. -<h3 class=fn>void <a name="setColumnStretchable"></a>TQTable::setColumnStretchable ( int col, bool stretch )<tt> [virtual slot]</tt> -</h3> -If <em>stretch</em> is TRUE, column <em>col</em> is set to be stretchable; -otherwise column <em>col</em> is set to be unstretchable. -<p> If the table widget's width decreases or increases stretchable -columns will grow narrower or wider to fit the space available as -completely as possible. The user cannot manually resize stretchable -columns. -<p> <p>See also <a href="#isColumnStretchable">isColumnStretchable</a>(), <a href="#setRowStretchable">setRowStretchable</a>(), and <a href="#adjustColumn">adjustColumn</a>(). - -<h3 class=fn>void <a name="setColumnWidth"></a>TQTable::setColumnWidth ( int col, int w )<tt> [virtual slot]</tt> -</h3> -Resizes column <em>col</em> to be <em>w</em> pixels wide. -<p> <p>See also <a href="#columnWidth">columnWidth</a>() and <a href="#setRowHeight">setRowHeight</a>(). - -<p>Example: <a href="tutorial2-08.html#x2620">chart/setdataform.cpp</a>. -<p>Reimplemented in <a href="tqdatatable.html#setColumnWidth">TQDataTable</a>. -<h3 class=fn>void <a name="setCurrentCell"></a>TQTable::setCurrentCell ( int row, int col )<tt> [virtual slot]</tt> -</h3> -Moves the focus to the cell at <em>row</em>, <em>col</em>. -<p> <p>See also <a href="#currentRow">currentRow</a>() and <a href="#currentColumn">currentColumn</a>(). - -<h3 class=fn>void <a name="setDragEnabled"></a>TQTable::setDragEnabled ( bool b )<tt> [virtual slot]</tt> -</h3> -If <em>b</em> is TRUE, the table starts a drag (see <a href="#dragObject">dragObject</a>()) when -the user presses and moves the mouse on a selected cell. - -<h3 class=fn>void <a name="setEditMode"></a>TQTable::setEditMode ( <a href="ntqtable.html#EditMode-enum">EditMode</a> mode, int row, int col )<tt> [protected]</tt> -</h3> -Sets the current edit mode to <em>mode</em>, the current edit row to <em>row</em> and the current edit column to <em>col</em>. -<p> <p>See also <a href="#EditMode-enum">EditMode</a>. - -<h3 class=fn>void <a name="setFocusStyle"></a>TQTable::setFocusStyle ( <a href="ntqtable.html#FocusStyle-enum">FocusStyle</a> fs )<tt> [virtual]</tt> -</h3><p>Sets how the current (focus) cell is drawn to <em>fs</em>. -See the <a href="ntqtable.html#focusStyle-prop">"focusStyle"</a> property for details. -<h3 class=fn>void <a name="setItem"></a>TQTable::setItem ( int row, int col, <a href="qtableitem.html">TQTableItem</a> * item )<tt> [virtual]</tt> -</h3> -Inserts the table item <em>item</em> into the table at row <em>row</em>, -column <em>col</em>, and repaints the cell. If a table item already -exists in this cell it is deleted and replaced with <em>item</em>. The -table takes ownership of the table item. -<p> If you don't use <a href="qtableitem.html">TQTableItem</a>s you may need to reimplement this -function: see the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>. -<p> <p>See also <a href="#item">item</a>() and <a href="#takeItem">takeItem</a>(). - -<p>Examples: <a href="helpsystem-example.html#x2691">helpsystem/mainwindow.cpp</a> and <a href="small-table-example-example.html#x2803">table/small-table-demo/main.cpp</a>. -<h3 class=fn>void <a name="setLeftMargin"></a>TQTable::setLeftMargin ( int m )<tt> [virtual slot]</tt> -</h3> -Sets the left margin to be <em>m</em> pixels wide. -<p> The <a href="#verticalHeader">verticalHeader</a>(), which displays row labels, occupies this -margin. -<p> In an Arabic or Hebrew <a href="i18n.html#localization">localization</a>, the verticalHeader() will -appear on the right side of the table, and this call will set the -right margin. -<p> <p>See also <a href="tqscrollview.html#leftMargin">leftMargin</a>(), <a href="#setTopMargin">setTopMargin</a>(), and <a href="#verticalHeader">verticalHeader</a>(). - -<p>Example: <a href="regexptester-example.html#x2501">regexptester/regexptester.cpp</a>. -<h3 class=fn>void <a name="setNumCols"></a>TQTable::setNumCols ( int r )<tt> [virtual slot]</tt> -</h3><p>Sets the number of columns in the table to <em>r</em>. -See the <a href="ntqtable.html#numCols-prop">"numCols"</a> property for details. -<h3 class=fn>void <a name="setNumRows"></a>TQTable::setNumRows ( int r )<tt> [virtual slot]</tt> -</h3><p>Sets the number of rows in the table to <em>r</em>. -See the <a href="ntqtable.html#numRows-prop">"numRows"</a> property for details. -<h3 class=fn>void <a name="setPixmap"></a>TQTable::setPixmap ( int row, int col, const <a href="tqpixmap.html">TQPixmap</a> & pix )<tt> [virtual]</tt> -</h3> -Sets the pixmap in the cell at <em>row</em>, <em>col</em> to <em>pix</em>. -<p> If the cell does not contain a table item a <a href="qtableitem.html">TQTableItem</a> is created -with an <a href="qtableitem.html#EditType-enum">EditType</a> of <tt>OnTyping</tt>, -otherwise the existing table item's pixmap (if any) is replaced -with <em>pix</em>. -<p> Note that <a href="tqcombotableitem.html">TQComboTableItem</a>s and <a href="tqchecktableitem.html">TQCheckTableItem</a>s don't show -pixmaps. -<p> <p>See also <a href="#pixmap">pixmap</a>(), <a href="#setText">setText</a>(), <a href="#setItem">setItem</a>(), and <a href="qtableitem.html#setPixmap">TQTableItem::setPixmap</a>(). - -<p>Examples: <a href="tutorial2-08.html#x2623">chart/setdataform.cpp</a> and <a href="small-table-example-example.html#x2804">table/small-table-demo/main.cpp</a>. -<h3 class=fn>void <a name="setReadOnly"></a>TQTable::setReadOnly ( bool b )<tt> [virtual slot]</tt> -</h3><p>Sets whether the table is read-only to <em>b</em>. -See the <a href="ntqtable.html#readOnly-prop">"readOnly"</a> property for details. -<h3 class=fn>void <a name="setRowHeight"></a>TQTable::setRowHeight ( int row, int h )<tt> [virtual slot]</tt> -</h3> -Resizes row <em>row</em> to be <em>h</em> pixels high. -<p> <p>See also <a href="#rowHeight">rowHeight</a>() and <a href="#setColumnWidth">setColumnWidth</a>(). - -<h3 class=fn>void <a name="setRowLabels"></a>TQTable::setRowLabels ( const <a href="tqstringlist.html">TQStringList</a> & labels )<tt> [slot]</tt> -</h3> Sets the section labels of the <a href="#verticalHeader">verticalHeader</a>() to <em>labels</em> -<h3 class=fn>void <a name="setRowMovingEnabled"></a>TQTable::setRowMovingEnabled ( bool b )<tt> [virtual slot]</tt> -</h3><p>Sets whether rows can be moved by the user to <em>b</em>. -See the <a href="ntqtable.html#rowMovingEnabled-prop">"rowMovingEnabled"</a> property for details. -<h3 class=fn>void <a name="setRowReadOnly"></a>TQTable::setRowReadOnly ( int row, bool ro )<tt> [virtual slot]</tt> -</h3> -If <em>ro</em> is TRUE, row <em>row</em> is set to be read-only; otherwise the -row is set to be editable. -<p> Whether a cell in this row is editable or read-only depends on the -cell's EditType, and this setting: -see <a href="qtableitem.html#wheneditable">TQTableItem::EditType</a>. -<p> <p>See also <a href="#isRowReadOnly">isRowReadOnly</a>(), <a href="#setColumnReadOnly">setColumnReadOnly</a>(), and <a href="#readOnly-prop">readOnly</a>. - -<h3 class=fn>void <a name="setRowStretchable"></a>TQTable::setRowStretchable ( int row, bool stretch )<tt> [virtual slot]</tt> -</h3> -If <em>stretch</em> is TRUE, row <em>row</em> is set to be stretchable; -otherwise row <em>row</em> is set to be unstretchable. -<p> If the table widget's height decreases or increases stretchable -rows will grow shorter or taller to fit the space available as -completely as possible. The user cannot manually resize -stretchable rows. -<p> <p>See also <a href="#isRowStretchable">isRowStretchable</a>() and <a href="#setColumnStretchable">setColumnStretchable</a>(). - -<h3 class=fn>void <a name="setSelectionMode"></a>TQTable::setSelectionMode ( <a href="ntqtable.html#SelectionMode-enum">SelectionMode</a> mode )<tt> [virtual]</tt> -</h3><p>Sets the current selection mode to <em>mode</em>. -See the <a href="ntqtable.html#selectionMode-prop">"selectionMode"</a> property for details. -<h3 class=fn>void <a name="setShowGrid"></a>TQTable::setShowGrid ( bool b )<tt> [virtual slot]</tt> -</h3><p>Sets whether the table's grid is displayed to <em>b</em>. -See the <a href="ntqtable.html#showGrid-prop">"showGrid"</a> property for details. -<h3 class=fn>void <a name="setSorting"></a>TQTable::setSorting ( bool b )<tt> [virtual slot]</tt> -</h3><p>Sets whether a click on the header of a column sorts that column to <em>b</em>. -See the <a href="ntqtable.html#sorting-prop">"sorting"</a> property for details. -<h3 class=fn>void <a name="setText"></a>TQTable::setText ( int row, int col, const <a href="tqstring.html">TQString</a> & text )<tt> [virtual]</tt> -</h3> -Sets the text in the cell at <em>row</em>, <em>col</em> to <em>text</em>. -<p> If the cell does not contain a table item a <a href="qtableitem.html">TQTableItem</a> is created -with an <a href="qtableitem.html#EditType-enum">EditType</a> of <tt>OnTyping</tt>, -otherwise the existing table item's text (if any) is replaced with -<em>text</em>. -<p> <p>See also <a href="#text">text</a>(), <a href="#setPixmap">setPixmap</a>(), <a href="#setItem">setItem</a>(), and <a href="qtableitem.html#setText">TQTableItem::setText</a>(). - -<p>Examples: <a href="tutorial2-08.html#x2624">chart/setdataform.cpp</a>, <a href="helpsystem-example.html#x2692">helpsystem/mainwindow.cpp</a>, <a href="regexptester-example.html#x2504">regexptester/regexptester.cpp</a>, and <a href="small-table-example-example.html#x2805">table/small-table-demo/main.cpp</a>. -<h3 class=fn>void <a name="setTopMargin"></a>TQTable::setTopMargin ( int m )<tt> [virtual slot]</tt> -</h3> -Sets the top margin to be <em>m</em> pixels high. -<p> The <a href="#horizontalHeader">horizontalHeader</a>(), which displays column labels, occupies -this margin. -<p> <p>See also <a href="tqscrollview.html#topMargin">topMargin</a>() and <a href="#setLeftMargin">setLeftMargin</a>(). - -<p>Example: <a href="regexptester-example.html#x2505">regexptester/regexptester.cpp</a>. -<h3 class=fn>void <a name="showColumn"></a>TQTable::showColumn ( int col )<tt> [virtual slot]</tt> -</h3> -Shows column <em>col</em>. -<p> <p>See also <a href="#hideColumn">hideColumn</a>() and <a href="#showRow">showRow</a>(). - -<h3 class=fn>bool <a name="showGrid"></a>TQTable::showGrid () const -</h3><p>Returns TRUE if the table's grid is displayed; otherwise returns FALSE. -See the <a href="ntqtable.html#showGrid-prop">"showGrid"</a> property for details. -<h3 class=fn>void <a name="showRow"></a>TQTable::showRow ( int row )<tt> [virtual slot]</tt> -</h3> -Shows row <em>row</em>. -<p> <p>See also <a href="#hideRow">hideRow</a>() and <a href="#showColumn">showColumn</a>(). - -<h3 class=fn>void <a name="sortColumn"></a>TQTable::sortColumn ( int col, bool ascending = TRUE, bool wholeRows = FALSE )<tt> [virtual]</tt> -</h3> -Sorts column <em>col</em>. If <em>ascending</em> is TRUE the sort is in -ascending order, otherwise the sort is in descending order. -<p> If <em>wholeRows</em> is TRUE, entire rows are sorted using <a href="#swapRows">swapRows</a>(); -otherwise only cells in the column are sorted using <a href="#swapCells">swapCells</a>(). -<p> Note that if you are not using TQTableItems you will need to -reimplement swapRows() and swapCells(). (See the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>.) -<p> <p>See also <a href="#swapRows">swapRows</a>(). - -<p>Example: <a href="statistics-example.html#x2784">table/statistics/statistics.cpp</a>. -<p>Reimplemented in <a href="tqdatatable.html#sortColumn">TQDataTable</a>. -<h3 class=fn>bool <a name="sorting"></a>TQTable::sorting () const -</h3><p>Returns TRUE if a click on the header of a column sorts that column; otherwise returns FALSE. -See the <a href="ntqtable.html#sorting-prop">"sorting"</a> property for details. -<h3 class=fn>void <a name="startDrag"></a>TQTable::startDrag ()<tt> [virtual protected]</tt> -</h3> -Starts a drag. -<p> Usually you don't need to call or reimplement this function yourself. -<p> <p>See also <a href="#dragObject">dragObject</a>(). - -<h3 class=fn>void <a name="swapCells"></a>TQTable::swapCells ( int row1, int col1, int row2, int col2 )<tt> [virtual slot]</tt> -</h3> -Swaps the contents of the cell at <em>row1</em>, <em>col1</em> with the -contents of the cell at <em>row2</em>, <em>col2</em>. -<p> This function is also called when the table is sorted. -<p> If you don't use <a href="qtableitem.html">TQTableItem</a>s and want your users to be able to -swap cells, you will need to reimplement this function. (See the -<a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>.) -<p> <p>See also <a href="#swapColumns">swapColumns</a>() and <a href="#swapRows">swapRows</a>(). - -<h3 class=fn>void <a name="swapColumns"></a>TQTable::swapColumns ( int col1, int col2, bool swapHeader = FALSE )<tt> [virtual slot]</tt> -</h3> -Swaps the data in <em>col1</em> with <em>col2</em>. -<p> This function is used to swap the positions of two columns. It is -called when the user changes the order of columns (see -<a href="#setColumnMovingEnabled">setColumnMovingEnabled</a>(), and when columns are sorted. -<p> If you don't use <a href="qtableitem.html">TQTableItem</a>s and want your users to be able to -swap columns you will need to reimplement this function. (See the -<a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>.) -<p> If <em>swapHeader</em> is TRUE, the columns' header contents is also -swapped. -<p> <p>See also <a href="#swapCells">swapCells</a>(). - -<h3 class=fn>void <a name="swapRows"></a>TQTable::swapRows ( int row1, int row2, bool swapHeader = FALSE )<tt> [virtual slot]</tt> -</h3> -Swaps the data in <em>row1</em> and <em>row2</em>. -<p> This function is used to swap the positions of two rows. It is -called when the user changes the order of rows (see -<a href="#setRowMovingEnabled">setRowMovingEnabled</a>()), and when rows are sorted. -<p> If you don't use <a href="qtableitem.html">TQTableItem</a>s and want your users to be able to -swap rows, e.g. for sorting, you will need to reimplement this -function. (See the <a href="ntqtable.html#notes-on-large-tables">notes on large tables</a>.) -<p> If <em>swapHeader</em> is TRUE, the rows' header contents is also -swapped. -<p> This function will not update the TQTable, you will have to do -this manually, e.g. by calling <a href="tqscrollview.html#updateContents">updateContents</a>(). -<p> <p>See also <a href="#swapColumns">swapColumns</a>() and <a href="#swapCells">swapCells</a>(). - -<h3 class=fn>void <a name="takeItem"></a>TQTable::takeItem ( <a href="qtableitem.html">TQTableItem</a> * i )<tt> [virtual]</tt> -</h3> -Takes the table item <em>i</em> out of the table. This function does <em>not</em> delete the table item. You must either delete the table item -yourself or put it into a table (using <a href="#setItem">setItem</a>()) which will then -take ownership of it. -<p> Use this function if you want to move an item from one cell in a -table to another, or to move an item from one table to another, -reinserting the item with setItem(). -<p> If you want to exchange two cells use <a href="#swapCells">swapCells</a>(). - -<h3 class=fn><a href="tqstring.html">TQString</a> <a name="text"></a>TQTable::text ( int row, int col ) const<tt> [virtual]</tt> -</h3> -Returns the text in the cell at <em>row</em>, <em>col</em>, or <a href="tqstring.html#TQString-null">TQString::null</a> -if the relevant item does not exist or has no text. -<p> <p>See also <a href="#setText">setText</a>() and <a href="#setPixmap">setPixmap</a>(). - -<p>Example: <a href="tutorial2-08.html#x2625">chart/setdataform.cpp</a>. -<p>Reimplemented in <a href="tqdatatable.html#text">TQDataTable</a>. -<h3 class=fn>void <a name="updateCell"></a>TQTable::updateCell ( int row, int col ) -</h3> -Repaints the cell at <em>row</em>, <em>col</em>. - -<h3 class=fn>void <a name="updateHeaderStates"></a>TQTable::updateHeaderStates () -</h3> -This functions updates all the header states to be in sync with -the current selections. This should be called after -programatically changing, adding or removing selections, so that -the headers are updated. - -<h3 class=fn>void <a name="valueChanged"></a>TQTable::valueChanged ( int row, int col )<tt> [signal]</tt> -</h3> - -<p> This signal is emitted when the user changed the value in the cell -at <em>row</em>, <em>col</em>. - -<p>Example: <a href="tutorial2-08.html#x2626">chart/setdataform.cpp</a>. -<h3 class=fn><a href="ntqheader.html">TQHeader</a> * <a name="verticalHeader"></a>TQTable::verticalHeader () const -</h3> -Returns the table's vertical <a href="ntqheader.html">TQHeader</a>. -<p> This header contains the row labels. -<p> <p>See also <a href="#horizontalHeader">horizontalHeader</a>(), <a href="#setLeftMargin">setLeftMargin</a>(), and <a href="ntqheader.html">TQHeader</a>. - -<p>Examples: <a href="helpsystem-example.html#x2693">helpsystem/mainwindow.cpp</a> and <a href="regexptester-example.html#x2506">regexptester/regexptester.cpp</a>. -<hr><h2>Property Documentation</h2> -<h3 class=fn>bool <a name="columnMovingEnabled-prop"></a>columnMovingEnabled</h3> -<p>This property holds whether columns can be moved by the user. -<p>The default is FALSE. Columns are moved by dragging whilst holding -down the Ctrl key. -<p> <b>Warning:</b> If TQTable is used to move header sections as a result of user -interaction, the mapping between header indexes and section exposed by -<a href="ntqheader.html">TQHeader</a> will not reflect the order of the headers in the table; i.e., -TQTable does not call <a href="ntqheader.html#moveSection">TQHeader::moveSection</a>() to move sections but handles -move operations internally. -<p> <p>See also <a href="#rowMovingEnabled-prop">rowMovingEnabled</a>. - -<p>Set this property's value with <a href="#setColumnMovingEnabled">setColumnMovingEnabled</a>() and get this property's value with <a href="#columnMovingEnabled">columnMovingEnabled</a>(). -<h3 class=fn><a href="ntqtable.html#FocusStyle-enum">FocusStyle</a> <a name="focusStyle-prop"></a>focusStyle</h3> -<p>This property holds how the current (focus) cell is drawn. -<p>The default style is <a href="#FocusStyle-enum">SpreadSheet</a>. -<p> <p>See also <a href="#FocusStyle-enum">TQTable::FocusStyle</a>. - -<p>Set this property's value with <a href="#setFocusStyle">setFocusStyle</a>() and get this property's value with <a href="#focusStyle">focusStyle</a>(). -<h3 class=fn>int <a name="numCols-prop"></a>numCols</h3> -<p>This property holds the number of columns in the table. -<p>Set this property's value with <a href="#setNumCols">setNumCols</a>() and get this property's value with <a href="#numCols">numCols</a>(). -<p><p>See also <a href="#numRows-prop">numRows</a>. - -<h3 class=fn>int <a name="numRows-prop"></a>numRows</h3> -<p>This property holds the number of rows in the table. -<p>Set this property's value with <a href="#setNumRows">setNumRows</a>() and get this property's value with <a href="#numRows">numRows</a>(). -<p><p>See also <a href="#numCols-prop">numCols</a>. - -<h3 class=fn>int <a name="numSelections-prop"></a>numSelections</h3> -<p>This property holds the number of selections. -<p>Get this property's value with <a href="#numSelections">numSelections</a>(). -<p><p>See also <a href="#currentSelection">currentSelection</a>(). - -<h3 class=fn>bool <a name="readOnly-prop"></a>readOnly</h3> -<p>This property holds whether the table is read-only. -<p>Whether a cell in the table is editable or read-only depends on -the cell's <a href="qtableitem.html#EditType-enum">EditType</a>, and this setting: -see <a href="qtableitem.html#wheneditable">TQTableItem::EditType</a>. -<p> <p>See also <a href="tqwidget.html#enabled-prop">TQWidget::enabled</a>, <a href="#setColumnReadOnly">setColumnReadOnly</a>(), and <a href="#setRowReadOnly">setRowReadOnly</a>(). - -<p>Set this property's value with <a href="#setReadOnly">setReadOnly</a>() and get this property's value with <a href="#isReadOnly">isReadOnly</a>(). -<h3 class=fn>bool <a name="rowMovingEnabled-prop"></a>rowMovingEnabled</h3> -<p>This property holds whether rows can be moved by the user. -<p>The default is FALSE. Rows are moved by dragging whilst holding -down the Ctrl key. -<p> <b>Warning:</b> If TQTable is used to move header sections as a result of user -interaction, the mapping between header indexes and section exposed by -<a href="ntqheader.html">TQHeader</a> will not reflect the order of the headers in the table; i.e., -TQTable does not call <a href="ntqheader.html#moveSection">TQHeader::moveSection</a>() to move sections but handles -move operations internally. -<p> <p>See also <a href="#columnMovingEnabled-prop">columnMovingEnabled</a>. - -<p>Set this property's value with <a href="#setRowMovingEnabled">setRowMovingEnabled</a>() and get this property's value with <a href="#rowMovingEnabled">rowMovingEnabled</a>(). -<h3 class=fn><a href="ntqtable.html#SelectionMode-enum">SelectionMode</a> <a name="selectionMode-prop"></a>selectionMode</h3> -<p>This property holds the current selection mode. -<p>The default mode is <a href="#SelectionMode-enum">Multi</a> which allows the user to select -multiple ranges of cells. -<p> <p>See also <a href="#SelectionMode-enum">SelectionMode</a> and <a href="#selectionMode-prop">selectionMode</a>. - -<p>Set this property's value with <a href="#setSelectionMode">setSelectionMode</a>() and get this property's value with <a href="#selectionMode">selectionMode</a>(). -<h3 class=fn>bool <a name="showGrid-prop"></a>showGrid</h3> -<p>This property holds whether the table's grid is displayed. -<p>The grid is shown by default. - -<p>Set this property's value with <a href="#setShowGrid">setShowGrid</a>() and get this property's value with <a href="#showGrid">showGrid</a>(). -<h3 class=fn>bool <a name="sorting-prop"></a>sorting</h3> -<p>This property holds whether a click on the header of a column sorts that column. -<p>Set this property's value with <a href="#setSorting">setSorting</a>() and get this property's value with <a href="#sorting">sorting</a>(). -<p><p>See also <a href="#sortColumn">sortColumn</a>(). - -<!-- eof --> -<hr><p> -This file is part of the <a href="index.html">TQt toolkit</a>. -Copyright © 1995-2007 -<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center> -<table width=100% cellspacing=0 border=0><tr> -<td>Copyright © 2007 -<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> -<td align=right><div align=right>TQt 3.3.8</div> -</table></div></address></body> -</html> |