You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
498 lines
29 KiB
498 lines
29 KiB
13 years ago
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||
3 months ago
|
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/table/tqtable.cpp:406 -->
|
||
|
13 years ago
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||
|
|
<title>TQTableItem 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>TQTableItem Class Reference<br><small>[<a href="table.html">table module</a>]</small></h1>
|
||
|
|
|
||
|
|
<p>The TQTableItem class provides the cell content for TQTable cells.
|
||
|
|
<a href="#details">More...</a>
|
||
|
3 months ago
|
<p><tt>#include <<a href="tqtable-h.html">tqtable.h</a>></tt>
|
||
|
13 years ago
|
<p>Inherits <a href="ntqt.html">TQt</a>.
|
||
|
4 months ago
|
<p>Inherited by <a href="tqcombotableitem.html">TQComboTableItem</a> and <a href="tqchecktableitem.html">TQCheckTableItem</a>.
|
||
|
3 months ago
|
<p><a href="tqtableitem-members.html">List of all member functions.</a>
|
||
|
13 years ago
|
<h2>Public Members</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn>enum <a href="#EditType-enum"><b>EditType</b></a> { Never, OnTyping, WhenCurrent, Always }</li>
|
||
|
|
<li class=fn><a href="#TQTableItem"><b>TQTableItem</b></a> ( TQTable * table, EditType et )</li>
|
||
|
|
<li class=fn><a href="#TQTableItem-2"><b>TQTableItem</b></a> ( TQTable * table, EditType et, const TQString & text )</li>
|
||
|
|
<li class=fn><a href="#TQTableItem-3"><b>TQTableItem</b></a> ( TQTable * table, EditType et, const TQString & text, const TQPixmap & p )</li>
|
||
|
|
<li class=fn>virtual <a href="#~TQTableItem"><b>~TQTableItem</b></a> ()</li>
|
||
|
|
<li class=fn>virtual TQPixmap <a href="#pixmap"><b>pixmap</b></a> () const</li>
|
||
|
|
<li class=fn>virtual TQString <a href="#text"><b>text</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#setPixmap"><b>setPixmap</b></a> ( const TQPixmap & p )</li>
|
||
|
|
<li class=fn>virtual void <a href="#setText"><b>setText</b></a> ( const TQString & str )</li>
|
||
|
|
<li class=fn>TQTable * <a href="#table"><b>table</b></a> () const</li>
|
||
|
|
<li class=fn>virtual int <a href="#alignment"><b>alignment</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#setWordWrap"><b>setWordWrap</b></a> ( bool b )</li>
|
||
|
|
<li class=fn>bool <a href="#wordWrap"><b>wordWrap</b></a> () const</li>
|
||
|
|
<li class=fn>EditType <a href="#editType"><b>editType</b></a> () const</li>
|
||
|
|
<li class=fn>virtual TQWidget * <a href="#createEditor"><b>createEditor</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#setContentFromEditor"><b>setContentFromEditor</b></a> ( TQWidget * w )</li>
|
||
|
|
<li class=fn>virtual void <a href="#setReplaceable"><b>setReplaceable</b></a> ( bool b )</li>
|
||
|
|
<li class=fn>bool <a href="#isReplaceable"><b>isReplaceable</b></a> () const</li>
|
||
|
|
<li class=fn>virtual TQString <a href="#key"><b>key</b></a> () const</li>
|
||
|
|
<li class=fn>virtual TQSize <a href="#sizeHint"><b>sizeHint</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#setSpan"><b>setSpan</b></a> ( int rs, int cs )</li>
|
||
|
|
<li class=fn>int <a href="#rowSpan"><b>rowSpan</b></a> () const</li>
|
||
|
|
<li class=fn>int <a href="#colSpan"><b>colSpan</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#setRow"><b>setRow</b></a> ( int r )</li>
|
||
|
|
<li class=fn>virtual void <a href="#setCol"><b>setCol</b></a> ( int c )</li>
|
||
|
|
<li class=fn>int <a href="#row"><b>row</b></a> () const</li>
|
||
|
|
<li class=fn>int <a href="#col"><b>col</b></a> () const</li>
|
||
|
|
<li class=fn>virtual void <a href="#paint"><b>paint</b></a> ( TQPainter * p, const TQColorGroup & cg, const TQRect & cr, bool selected )</li>
|
||
|
|
<li class=fn>virtual void <a href="#setEnabled"><b>setEnabled</b></a> ( bool b )</li>
|
||
|
|
<li class=fn>bool <a href="#isEnabled"><b>isEnabled</b></a> () const</li>
|
||
|
|
<li class=fn>virtual int <a href="#rtti"><b>rtti</b></a> () const</li>
|
||
|
|
</ul>
|
||
|
|
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||
|
|
|
||
|
|
|
||
|
3 months ago
|
The TQTableItem class provides the cell content for <a href="tqtable.html">TQTable</a> cells.
|
||
|
13 years ago
|
|
||
|
|
<p>
|
||
|
|
|
||
|
|
<p> For many applications TQTableItems are ideal for presenting and
|
||
|
|
editing the contents of TQTable cells. In situations where you need
|
||
|
|
to create very large tables you may prefer an alternative approach
|
||
|
3 months ago
|
to using TQTableItems: see the <a href="tqtable.html#notes-on-large-tables">notes on large tables</a>.
|
||
|
13 years ago
|
<p> A TQTableItem contains a cell's data, by default, a string and a
|
||
|
|
pixmap. The table item also holds the cell's display size and how
|
||
|
|
the data should be aligned. The table item specifies the cell's
|
||
|
|
<a href="#EditType-enum">EditType</a> and the editor used for in-place editing (by default a
|
||
|
4 months ago
|
<a href="tqlineedit.html">TQLineEdit</a>). If you want checkboxes use <a href="tqchecktableitem.html">TQCheckTableItem</a>, and if
|
||
|
|
you want comboboxes use <a href="tqcombotableitem.html">TQComboTableItem</a>. The <a href="#EditType-enum">EditType</a> (set
|
||
|
13 years ago
|
in the constructor) determines whether the cell's contents may be
|
||
|
|
edited.
|
||
|
|
<p> If a pixmap is specified it is displayed to the left of any text.
|
||
|
|
You can change the text or pixmap with <a href="#setText">setText</a>() and <a href="#setPixmap">setPixmap</a>()
|
||
|
|
respectively. For text you can use <a href="#setWordWrap">setWordWrap</a>().
|
||
|
|
<p> When sorting table items the <a href="#key">key</a>() function is used; by default
|
||
|
|
this returns the table item's <a href="#text">text</a>(). Reimplement key() to
|
||
|
|
customize how your table items will sort.
|
||
|
3 months ago
|
<p> Table items are inserted into a table using <a href="tqtable.html#setItem">TQTable::setItem</a>(). If
|
||
|
13 years ago
|
you insert an item into a cell that already contains a table item
|
||
|
|
the original item will be deleted.
|
||
|
|
<p> Example:
|
||
|
|
<pre>
|
||
|
|
for ( int row = 0; row < table->numRows(); row++ ) {
|
||
|
|
for ( int col = 0; col < table->numCols(); col++ ) {
|
||
|
|
table->setItem( row, col,
|
||
|
|
new TQTableItem( table, TQTableItem::<a href="#EditType-enum">WhenCurrent</a>, TQString::number( row * col ) ) );
|
||
|
|
}
|
||
|
|
}
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p> You can move a table item from one cell to another, in the same or
|
||
|
3 months ago
|
a different table, using <a href="tqtable.html#takeItem">TQTable::takeItem</a>() and TQTable::setItem()
|
||
|
|
but see also <a href="tqtable.html#swapCells">TQTable::swapCells</a>().
|
||
|
13 years ago
|
<p> Table items can be deleted with delete in the standard way; the
|
||
|
|
table and cell will be updated accordingly.
|
||
|
|
<p> Note, that if you have a table item that is not currently in a table
|
||
|
|
then anything you do to that item other than insert it into a table
|
||
|
|
will result in undefined behaviour.
|
||
|
|
<p> Reimplement <a href="#createEditor">createEditor</a>() and <a href="#setContentFromEditor">setContentFromEditor</a>() if you want
|
||
|
4 months ago
|
to use your own widget instead of a <a href="tqlineedit.html">TQLineEdit</a> for editing cell
|
||
|
13 years ago
|
contents. Reimplement <a href="#paint">paint</a>() if you want to display custom
|
||
|
|
content.
|
||
|
|
<p> It is important to ensure that your custom widget can accept the
|
||
|
|
<a href="focus.html#keyboard-focus">keyboard focus</a>, so that the user can use the tab key to navigate the
|
||
|
|
table as normal. Therefore, if the widget returned by createEditor()
|
||
|
|
does not itself accept the keyboard focus, it is necessary to
|
||
|
|
nominate a child widget to do so on its behalf. For example, a
|
||
|
13 years ago
|
<a href="ntqhbox.html">TQHBox</a> with two child TQLineEdit widgets may use one of them to
|
||
|
13 years ago
|
accept the keyboard focus:
|
||
|
|
<p> <pre>
|
||
|
|
TQWidget* MyTableItem::createEditor() const
|
||
|
|
{
|
||
|
13 years ago
|
<a href="ntqhbox.html">TQHBox</a>* hbox = new <a href="ntqhbox.html">TQHBox</a>( <a href="#table">table</a>()->viewport() );
|
||
|
4 months ago
|
hbox-><a href="tqwidget.html#setFocusProxy">setFocusProxy</a>(new <a href="tqlineedit.html">TQLineEdit</a>( hbox ));
|
||
|
|
new <a href="tqlineedit.html">TQLineEdit</a>( hbox );
|
||
|
13 years ago
|
return hbox;
|
||
|
|
}
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p> By default, table items may be replaced by new TQTableItems
|
||
|
3 months ago
|
during the lifetime of a <a href="tqtable.html">TQTable</a>. Therefore, if you create your
|
||
|
13 years ago
|
own subclass of TQTableItem, and you want to ensure that
|
||
|
|
this does not happen, you must call <a href="#setReplaceable">setReplaceable</a>(FALSE)
|
||
|
|
in the constructor of your subclass.
|
||
|
3 months ago
|
<p> <center><img src="tqtableitems.png" alt="Table Items"></center>
|
||
|
4 months ago
|
<p> <p>See also <a href="tqchecktableitem.html">TQCheckTableItem</a>, <a href="tqcombotableitem.html">TQComboTableItem</a>, and <a href="advanced.html">Advanced Widgets</a>.
|
||
|
13 years ago
|
|
||
|
|
<p>
|
||
|
|
<hr><h2>Member Type Documentation</h2>
|
||
|
|
<h3 class=fn><a name="EditType-enum"></a>TQTableItem::EditType</h3>
|
||
|
|
|
||
|
|
<p> <a name="wheneditable"></a>
|
||
|
|
This enum is used to define whether a cell is editable or
|
||
|
|
read-only (in conjunction with other settings), and how the cell
|
||
|
|
should be displayed.
|
||
|
|
<ul>
|
||
|
|
<li><tt>TQTableItem::Always</tt> -
|
||
|
|
The cell always <em>looks</em> editable.
|
||
|
|
</ul><p> Using this EditType ensures that the editor created with
|
||
|
4 months ago
|
<a href="#createEditor">createEditor</a>() (by default a <a href="tqlineedit.html">TQLineEdit</a>) is always visible. This
|
||
|
13 years ago
|
has implications for the alignment of the content: the default
|
||
|
|
editor aligns everything (even numbers) to the left whilst
|
||
|
|
numerical values in the cell are by default aligned to the right.
|
||
|
|
<p> If a cell with the edit type <a href="#EditType-enum">Always</a> looks misaligned you could
|
||
|
|
reimplement createEditor() for these items.
|
||
|
|
<ul>
|
||
|
|
<li><tt>TQTableItem::WhenCurrent</tt> -
|
||
|
|
The cell <em>looks</em> editable only when it has <a href="focus.html#keyboard-focus">keyboard focus</a> (see
|
||
|
3 months ago
|
<a href="tqtable.html#setCurrentCell">TQTable::setCurrentCell</a>()).
|
||
|
13 years ago
|
<li><tt>TQTableItem::OnTyping</tt> -
|
||
|
|
The cell <em>looks</em> editable only when the user types in it or
|
||
|
|
double-clicks it. It resembles the <a href="#EditType-enum">WhenCurrent</a> functionality
|
||
|
|
but is, perhaps, nicer.
|
||
|
|
</ul><p> The <a href="#EditType-enum">OnTyping</a> edit type is the default when TQTableItem objects
|
||
|
3 months ago
|
are created by the convenience functions <a href="tqtable.html#setText">TQTable::setText</a>() and
|
||
|
|
<a href="tqtable.html#setPixmap">TQTable::setPixmap</a>().
|
||
|
13 years ago
|
<ul>
|
||
|
|
<li><tt>TQTableItem::Never</tt> - The cell is not editable.
|
||
|
3 months ago
|
</ul><p> The cell is actually editable only if <a href="tqtable.html#isRowReadOnly">TQTable::isRowReadOnly</a>() is
|
||
|
|
FALSE for its row, <a href="tqtable.html#isColumnReadOnly">TQTable::isColumnReadOnly</a>() is FALSE for its
|
||
|
|
column, and <a href="tqtable.html#isReadOnly">TQTable::isReadOnly</a>() is FALSE.
|
||
|
13 years ago
|
<p> TQComboTableItems have an isEditable() property. This property is
|
||
|
|
used to indicate whether the user may enter their own text or are
|
||
|
|
restricted to choosing one of the choices in the list.
|
||
|
|
TQComboTableItems may be interacted with only if they are editable
|
||
|
|
in accordance with their EditType as described above.
|
||
|
|
<p>
|
||
|
|
<hr><h2>Member Function Documentation</h2>
|
||
|
3 months ago
|
<h3 class=fn><a name="TQTableItem"></a>TQTableItem::TQTableItem ( <a href="tqtable.html">TQTable</a> * table, <a href="tqtableitem.html#EditType-enum">EditType</a> et )
|
||
|
13 years ago
|
</h3>
|
||
|
|
Creates a table item that is a child of table <em>table</em> with no
|
||
|
|
text. The item has the <a href="#EditType-enum">EditType</a> <em>et</em>.
|
||
|
4 months ago
|
<p> The table item will use a <a href="tqlineedit.html">TQLineEdit</a> for its editor, will not
|
||
|
13 years ago
|
word-wrap and will occupy a single cell. Insert the table item
|
||
|
3 months ago
|
into a table with <a href="tqtable.html#setItem">TQTable::setItem</a>().
|
||
|
13 years ago
|
<p> The table takes ownership of the table item, so a table item
|
||
|
|
should not be inserted into more than one table at a time.
|
||
|
|
|
||
|
3 months ago
|
<h3 class=fn><a name="TQTableItem-2"></a>TQTableItem::TQTableItem ( <a href="tqtable.html">TQTable</a> * table, <a href="tqtableitem.html#EditType-enum">EditType</a> et, const <a href="tqstring.html">TQString</a> & text )
|
||
|
13 years ago
|
</h3>
|
||
|
|
Creates a table item that is a child of table <em>table</em> with text
|
||
|
|
<em>text</em>. The item has the <a href="#EditType-enum">EditType</a> <em>et</em>.
|
||
|
4 months ago
|
<p> The table item will use a <a href="tqlineedit.html">TQLineEdit</a> for its editor, will not
|
||
|
13 years ago
|
word-wrap and will occupy a single cell. Insert the table item
|
||
|
3 months ago
|
into a table with <a href="tqtable.html#setItem">TQTable::setItem</a>().
|
||
|
13 years ago
|
<p> The table takes ownership of the table item, so a table item
|
||
|
|
should not be inserted into more than one table at a time.
|
||
|
|
|
||
|
3 months ago
|
<h3 class=fn><a name="TQTableItem-3"></a>TQTableItem::TQTableItem ( <a href="tqtable.html">TQTable</a> * table, <a href="tqtableitem.html#EditType-enum">EditType</a> et, const <a href="tqstring.html">TQString</a> & text, const <a href="tqpixmap.html">TQPixmap</a> & p )
|
||
|
13 years ago
|
</h3>
|
||
|
|
Creates a table item that is a child of table <em>table</em> with text
|
||
|
|
<em>text</em> and pixmap <em>p</em>. The item has the <a href="#EditType-enum">EditType</a> <em>et</em>.
|
||
|
|
<p> The table item will display the pixmap to the left of the text. It
|
||
|
4 months ago
|
will use a <a href="tqlineedit.html">TQLineEdit</a> for editing the text, will not word-wrap and
|
||
|
13 years ago
|
will occupy a single cell. Insert the table item into a table with
|
||
|
3 months ago
|
<a href="tqtable.html#setItem">TQTable::setItem</a>().
|
||
|
13 years ago
|
<p> The table takes ownership of the table item, so a table item
|
||
|
|
should not be inserted in more than one table at a time.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="~TQTableItem"></a>TQTableItem::~TQTableItem ()<tt> [virtual]</tt>
|
||
|
|
</h3>
|
||
|
|
The destructor deletes this item and frees all allocated
|
||
|
|
resources.
|
||
|
|
<p> If the table item is in a table (i.e. was inserted with
|
||
|
|
setItem()), it will be removed from the table and the cell it
|
||
|
|
occupied.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="alignment"></a>TQTableItem::alignment () const<tt> [virtual]</tt>
|
||
|
|
</h3>
|
||
|
|
The alignment function returns how the text contents of the cell
|
||
|
|
are aligned when drawn. The default implementation aligns numbers
|
||
|
|
to the right and any other text to the left.
|
||
|
13 years ago
|
<p> <p>See also <a href="ntqt.html#AlignmentFlags-enum">TQt::AlignmentFlags</a>.
|
||
|
13 years ago
|
|
||
|
|
<h3 class=fn>int <a name="col"></a>TQTableItem::col () const
|
||
|
|
</h3>
|
||
|
|
Returns the column where the table item is located. If the cell
|
||
|
|
spans multiple columns, this function returns the left-most
|
||
|
|
column.
|
||
|
|
<p> <p>See also <a href="#row">row</a>() and <a href="#setCol">setCol</a>().
|
||
|
|
|
||
|
|
<p>Example: <a href="bigtable-example.html#x1293">table/bigtable/main.cpp</a>.
|
||
|
|
<h3 class=fn>int <a name="colSpan"></a>TQTableItem::colSpan () const
|
||
|
|
</h3>
|
||
|
|
Returns the column span of the table item, usually 1.
|
||
|
|
<p> <p>See also <a href="#setSpan">setSpan</a>() and <a href="#rowSpan">rowSpan</a>().
|
||
|
|
|
||
|
6 months ago
|
<h3 class=fn><a href="tqwidget.html">TQWidget</a> * <a name="createEditor"></a>TQTableItem::createEditor () const<tt> [virtual]</tt>
|
||
|
13 years ago
|
</h3>
|
||
|
|
This virtual function creates an editor which the user can
|
||
|
|
interact with to edit the cell's contents. The default
|
||
|
4 months ago
|
implementation creates a <a href="tqlineedit.html">TQLineEdit</a>.
|
||
|
13 years ago
|
<p> If the function returns 0, the cell is read-only.
|
||
|
|
<p> The returned widget should preferably be invisible, ideally with
|
||
|
4 months ago
|
<a href="tqscrollview.html#viewport">TQTable::viewport</a>() as parent.
|
||
|
13 years ago
|
<p> If you reimplement this function you'll almost certainly need to
|
||
|
|
reimplement <a href="#setContentFromEditor">setContentFromEditor</a>(), and may need to reimplement
|
||
|
|
<a href="#sizeHint">sizeHint</a>().
|
||
|
|
<p>
|
||
|
|
|
||
|
|
<pre> <a name="x2444"></a>TQWidget *ComboItem::<a href="#createEditor">createEditor</a>() const
|
||
|
|
{
|
||
|
|
// create an editor - a combobox in our case
|
||
|
4 months ago
|
( (ComboItem*)this )->cb = new <a href="tqcombobox.html">TQComboBox</a>( <a href="#table">table</a>()->viewport() );
|
||
|
6 months ago
|
TQObject::<a href="tqobject.html#connect">connect</a>( cb, TQ_SIGNAL( activated( int ) ), table(), TQ_SLOT( doValueChanged() ) );
|
||
|
13 years ago
|
cb->insertItem( "Yes" );
|
||
|
|
cb->insertItem( "No" );
|
||
|
|
// and initialize it
|
||
|
|
cb->setCurrentItem( <a href="#text">text</a>() == "No" ? 1 : 0 );
|
||
|
|
return cb;
|
||
|
|
</pre>
|
||
|
3 months ago
|
<p> <p>See also <a href="tqtable.html#createEditor">TQTable::createEditor</a>(), <a href="#setContentFromEditor">setContentFromEditor</a>(), <a href="tqscrollview.html#viewport">TQTable::viewport</a>(), and <a href="#setReplaceable">setReplaceable</a>().
|
||
|
13 years ago
|
|
||
|
3 months ago
|
<p>Example: <a href="tqtableitem.html#x2444">table/statistics/statistics.cpp</a>.
|
||
|
|
<h3 class=fn><a href="tqtableitem.html#EditType-enum">EditType</a> <a name="editType"></a>TQTableItem::editType () const
|
||
|
13 years ago
|
</h3>
|
||
|
|
Returns the table item's edit type.
|
||
|
|
<p> This is set when the table item is constructed.
|
||
|
|
<p> <p>See also <a href="#EditType-enum">EditType</a> and <a href="#TQTableItem">TQTableItem</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isEnabled"></a>TQTableItem::isEnabled () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if the table item is enabled; otherwise returns FALSE.
|
||
|
|
<p> <p>See also <a href="#setEnabled">setEnabled</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isReplaceable"></a>TQTableItem::isReplaceable () const
|
||
|
|
</h3>
|
||
|
|
This function returns whether the contents of the cell may be
|
||
|
|
replaced with the contents of another table item. Regardless of
|
||
|
|
this setting, table items that span more than one cell may not
|
||
|
|
have their contents replaced by another table item.
|
||
|
|
<p> (This differs from <a href="#EditType-enum">EditType</a> because EditType is concerned with
|
||
|
|
whether the <em>user</em> is able to change the contents of a cell.)
|
||
|
|
<p> <p>See also <a href="#setReplaceable">setReplaceable</a>() and <a href="#EditType-enum">EditType</a>.
|
||
|
|
|
||
|
6 months ago
|
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="key"></a>TQTableItem::key () const<tt> [virtual]</tt>
|
||
|
13 years ago
|
</h3>
|
||
|
|
This virtual function returns the key that should be used for
|
||
|
|
sorting. The default implementation returns the <a href="#text">text</a>() of the
|
||
|
|
relevant item.
|
||
|
3 months ago
|
<p> <p>See also <a href="tqtable.html#sorting-prop">TQTable::sorting</a>.
|
||
|
13 years ago
|
|
||
|
4 months ago
|
<h3 class=fn>void <a name="paint"></a>TQTableItem::paint ( <a href="tqpainter.html">TQPainter</a> * p, const <a href="tqcolorgroup.html">TQColorGroup</a> & cg, const <a href="tqrect.html">TQRect</a> & cr, bool selected )<tt> [virtual]</tt>
|
||
|
13 years ago
|
</h3>
|
||
|
|
This virtual function is used to paint the contents of an item
|
||
|
|
using the painter <em>p</em> in the rectangular area <em>cr</em> using the
|
||
|
|
color group <em>cg</em>.
|
||
|
|
<p> If <em>selected</em> is TRUE the cell is displayed in a way that
|
||
|
|
indicates that it is highlighted.
|
||
|
|
<p> You don't usually need to use this function but if you want to
|
||
|
|
draw custom content in a cell you will need to reimplement it.
|
||
|
|
<p> The painter passed to this function is translated so that 0, 0
|
||
|
|
is the top-left corner of the item that is being painted.
|
||
|
|
<p> Note that the painter is not clipped by default in order to get
|
||
|
|
maximum efficiency. If you want clipping, use
|
||
|
|
<p> <pre>
|
||
|
|
p->setClipRect( <a href="#table">table</a>()->cellRect(row, col), TQPainter::ClipPainter );
|
||
|
|
//... your drawing code
|
||
|
|
p->setClipping( FALSE );
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
<p>Example: <a href="statistics-example.html#x2786">table/statistics/statistics.cpp</a>.
|
||
|
4 months ago
|
<h3 class=fn><a href="tqpixmap.html">TQPixmap</a> <a name="pixmap"></a>TQTableItem::pixmap () const<tt> [virtual]</tt>
|
||
|
13 years ago
|
</h3>
|
||
|
|
Returns the table item's pixmap or a null pixmap if no pixmap has
|
||
|
|
been set.
|
||
|
|
<p> <p>See also <a href="#setPixmap">setPixmap</a>() and <a href="#text">text</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="row"></a>TQTableItem::row () const
|
||
|
|
</h3>
|
||
|
|
Returns the row where the table item is located. If the cell spans
|
||
|
|
multiple rows, this function returns the top-most row.
|
||
|
|
<p> <p>See also <a href="#col">col</a>() and <a href="#setRow">setRow</a>().
|
||
|
|
|
||
|
|
<p>Example: <a href="bigtable-example.html#x1294">table/bigtable/main.cpp</a>.
|
||
|
|
<h3 class=fn>int <a name="rowSpan"></a>TQTableItem::rowSpan () const
|
||
|
|
</h3>
|
||
|
|
Returns the row span of the table item, usually 1.
|
||
|
|
<p> <p>See also <a href="#setSpan">setSpan</a>() and <a href="#colSpan">colSpan</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="rtti"></a>TQTableItem::rtti () const<tt> [virtual]</tt>
|
||
|
|
</h3>
|
||
|
|
Returns the Run Time Type Identification value for this table item
|
||
|
|
which for TQTableItems is 0.
|
||
|
|
<p> When you create subclasses based on TQTableItem make sure that each
|
||
|
|
subclass returns a unique <a href="#rtti">rtti</a>() value. It is advisable to use
|
||
|
|
values greater than 1000, preferably large random numbers, to
|
||
|
|
allow for extensions to this class.
|
||
|
4 months ago
|
<p> <p>See also <a href="tqchecktableitem.html#rtti">TQCheckTableItem::rtti</a>() and <a href="tqcombotableitem.html#rtti">TQComboTableItem::rtti</a>().
|
||
|
13 years ago
|
|
||
|
4 months ago
|
<p>Reimplemented in <a href="tqcombotableitem.html#rtti">TQComboTableItem</a> and <a href="tqchecktableitem.html#rtti">TQCheckTableItem</a>.
|
||
|
13 years ago
|
<h3 class=fn>void <a name="setCol"></a>TQTableItem::setCol ( int c )<tt> [virtual]</tt>
|
||
|
|
</h3>
|
||
|
|
Sets column <em>c</em> as the table item's column. Usually you will not
|
||
|
|
need to call this function.
|
||
|
|
<p> If the cell spans multiple columns, this function sets the
|
||
|
|
left-most column and retains the width of the multi-cell table
|
||
|
|
item.
|
||
|
|
<p> <p>See also <a href="#col">col</a>(), <a href="#setRow">setRow</a>(), and <a href="#colSpan">colSpan</a>().
|
||
|
|
|
||
|
6 months ago
|
<h3 class=fn>void <a name="setContentFromEditor"></a>TQTableItem::setContentFromEditor ( <a href="tqwidget.html">TQWidget</a> * w )<tt> [virtual]</tt>
|
||
|
13 years ago
|
</h3>
|
||
|
|
Whenever the content of a cell has been edited by the editor <em>w</em>,
|
||
|
3 months ago
|
<a href="tqtable.html">TQTable</a> calls this virtual function to copy the new values into the
|
||
|
13 years ago
|
TQTableItem.
|
||
|
|
<p> If you reimplement <a href="#createEditor">createEditor</a>() and return something that is not
|
||
|
4 months ago
|
a <a href="tqlineedit.html">TQLineEdit</a> you will need to reimplement this function.
|
||
|
13 years ago
|
<p>
|
||
|
|
|
||
|
6 months ago
|
<pre> void ComboItem::<a href="#setContentFromEditor">setContentFromEditor</a>( <a href="tqwidget.html">TQWidget</a> *w )
|
||
|
13 years ago
|
{
|
||
|
|
// the user changed the value of the combobox, so synchronize the
|
||
|
|
// value of the item (its text), with the value of the combobox
|
||
|
6 months ago
|
if ( w-><a href="tqobject.html#inherits">inherits</a>( "TQComboBox" ) )
|
||
|
13 years ago
|
<a href="#setText">setText</a>( ( (TQComboBox*)w )->currentText() );
|
||
|
|
else
|
||
|
|
TQTableItem::<a href="#setContentFromEditor">setContentFromEditor</a>( w );
|
||
|
|
</pre>
|
||
|
3 months ago
|
<p> <p>See also <a href="tqtable.html#setCellContentFromEditor">TQTable::setCellContentFromEditor</a>().
|
||
|
13 years ago
|
|
||
|
|
<p>Example: <a href="statistics-example.html#x2787">table/statistics/statistics.cpp</a>.
|
||
|
|
<h3 class=fn>void <a name="setEnabled"></a>TQTableItem::setEnabled ( bool b )<tt> [virtual]</tt>
|
||
|
|
</h3>
|
||
|
|
If <em>b</em> is TRUE, the table item is enabled; if <em>b</em> is FALSE the
|
||
|
|
table item is disabled.
|
||
|
|
<p> A disabled item doesn't respond to user interaction.
|
||
|
|
<p> <p>See also <a href="#isEnabled">isEnabled</a>().
|
||
|
|
|
||
|
4 months ago
|
<h3 class=fn>void <a name="setPixmap"></a>TQTableItem::setPixmap ( const <a href="tqpixmap.html">TQPixmap</a> & p )<tt> [virtual]</tt>
|
||
|
13 years ago
|
</h3>
|
||
|
|
Sets pixmap <em>p</em> to be this item's pixmap.
|
||
|
|
<p> Note that <a href="#setPixmap">setPixmap</a>() does not update the cell the table item
|
||
|
3 months ago
|
belongs to. Use <a href="tqtable.html#updateCell">TQTable::updateCell</a>() to repaint the cell's
|
||
|
13 years ago
|
contents.
|
||
|
4 months ago
|
<p> For <a href="tqcombotableitem.html">TQComboTableItem</a>s and <a href="tqchecktableitem.html">TQCheckTableItem</a>s this function
|
||
|
13 years ago
|
has no visible effect.
|
||
|
3 months ago
|
<p> <p>See also <a href="tqtable.html#setPixmap">TQTable::setPixmap</a>(), <a href="#pixmap">pixmap</a>(), and <a href="#setText">setText</a>().
|
||
|
13 years ago
|
|
||
|
|
<h3 class=fn>void <a name="setReplaceable"></a>TQTableItem::setReplaceable ( bool b )<tt> [virtual]</tt>
|
||
|
|
</h3>
|
||
|
|
If <em>b</em> is TRUE it is acceptable to replace the contents of the
|
||
|
|
cell with the contents of another TQTableItem. If <em>b</em> is FALSE the
|
||
|
|
contents of the cell may not be replaced by the contents of
|
||
|
|
another table item. Table items that span more than one cell may
|
||
|
|
not have their contents replaced by another table item.
|
||
|
|
<p> (This differs from <a href="#EditType-enum">EditType</a> because EditType is concerned with
|
||
|
|
whether the <em>user</em> is able to change the contents of a cell.)
|
||
|
|
<p> <p>See also <a href="#isReplaceable">isReplaceable</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>void <a name="setRow"></a>TQTableItem::setRow ( int r )<tt> [virtual]</tt>
|
||
|
|
</h3>
|
||
|
|
Sets row <em>r</em> as the table item's row. Usually you do not need to
|
||
|
|
call this function.
|
||
|
|
<p> If the cell spans multiple rows, this function sets the top row
|
||
|
|
and retains the height of the multi-cell table item.
|
||
|
|
<p> <p>See also <a href="#row">row</a>(), <a href="#setCol">setCol</a>(), and <a href="#rowSpan">rowSpan</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>void <a name="setSpan"></a>TQTableItem::setSpan ( int rs, int cs )<tt> [virtual]</tt>
|
||
|
|
</h3>
|
||
|
|
Changes the extent of the TQTableItem so that it spans multiple
|
||
|
|
cells covering <em>rs</em> rows and <em>cs</em> columns. The top left cell is
|
||
|
|
the original cell.
|
||
|
|
<p> <b>Warning:</b> This function only works if the item has already been
|
||
|
3 months ago
|
inserted into the table using e.g. <a href="tqtable.html#setItem">TQTable::setItem</a>(). This
|
||
|
13 years ago
|
function also checks to make sure if <em>rs</em> and <em>cs</em> are within
|
||
|
|
the bounds of the table and returns without changing the span if
|
||
|
|
they are not. In addition swapping, inserting or removing rows and
|
||
|
|
columns that cross TQTableItems spanning more than one cell is not
|
||
|
|
supported.
|
||
|
|
<p> <p>See also <a href="#rowSpan">rowSpan</a>() and <a href="#colSpan">colSpan</a>().
|
||
|
|
|
||
|
6 months ago
|
<h3 class=fn>void <a name="setText"></a>TQTableItem::setText ( const <a href="tqstring.html">TQString</a> & str )<tt> [virtual]</tt>
|
||
|
13 years ago
|
</h3>
|
||
|
|
Changes the table item's text to <em>str</em>.
|
||
|
|
<p> Note that <a href="#setText">setText</a>() does not update the cell the table item
|
||
|
3 months ago
|
belongs to. Use <a href="tqtable.html#updateCell">TQTable::updateCell</a>() to repaint the cell's
|
||
|
13 years ago
|
contents.
|
||
|
3 months ago
|
<p> <p>See also <a href="tqtable.html#setText">TQTable::setText</a>(), <a href="#text">text</a>(), <a href="#setPixmap">setPixmap</a>(), and <a href="tqtable.html#updateCell">TQTable::updateCell</a>().
|
||
|
13 years ago
|
|
||
|
|
<p>Example: <a href="statistics-example.html#x2788">table/statistics/statistics.cpp</a>.
|
||
|
|
<h3 class=fn>void <a name="setWordWrap"></a>TQTableItem::setWordWrap ( bool b )<tt> [virtual]</tt>
|
||
|
|
</h3>
|
||
|
|
If <em>b</em> is TRUE, the cell's text will be wrapped over multiple
|
||
|
|
lines, when necessary, to fit the width of the cell; otherwise the
|
||
|
|
text will be written as a single line.
|
||
|
3 months ago
|
<p> <p>See also <a href="#wordWrap">wordWrap</a>(), <a href="tqtable.html#adjustColumn">TQTable::adjustColumn</a>(), and <a href="tqtable.html#setColumnStretchable">TQTable::setColumnStretchable</a>().
|
||
|
13 years ago
|
|
||
|
5 months ago
|
<h3 class=fn><a href="tqsize.html">TQSize</a> <a name="sizeHint"></a>TQTableItem::sizeHint () const<tt> [virtual]</tt>
|
||
|
13 years ago
|
</h3>
|
||
|
|
This virtual function returns the size a cell needs to show its
|
||
|
|
entire content.
|
||
|
|
<p> If you subclass TQTableItem you will often need to reimplement this
|
||
|
|
function.
|
||
|
|
|
||
|
3 months ago
|
<h3 class=fn><a href="tqtable.html">TQTable</a> * <a name="table"></a>TQTableItem::table () const
|
||
|
13 years ago
|
</h3>
|
||
|
|
|
||
|
3 months ago
|
<p> Returns the <a href="tqtable.html">TQTable</a> the table item belongs to.
|
||
|
|
<p> <p>See also <a href="tqtable.html#setItem">TQTable::setItem</a>() and <a href="#TQTableItem">TQTableItem</a>().
|
||
|
13 years ago
|
|
||
|
6 months ago
|
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="text"></a>TQTableItem::text () const<tt> [virtual]</tt>
|
||
|
13 years ago
|
</h3>
|
||
|
6 months ago
|
Returns the text of the table item or <a href="tqstring.html#TQString-null">TQString::null</a> if there is no
|
||
|
13 years ago
|
text.
|
||
|
|
<p> To ensure that the current value of the editor is returned,
|
||
|
|
<a href="#setContentFromEditor">setContentFromEditor</a>() is called:
|
||
|
|
<ol type=1>
|
||
|
|
<li> if the editMode() is <a href="#EditType-enum">Always</a>, or
|
||
|
|
<li> if editMode() is <em>not</em> <a href="#EditType-enum">Always</a> but the editor of the cell is
|
||
|
4 months ago
|
active and the editor is not a <a href="tqlineedit.html">TQLineEdit</a>.
|
||
|
13 years ago
|
</ol>
|
||
|
|
<p> This means that <a href="#text">text</a>() returns the original text value of the item
|
||
|
|
if the editor is a line edit, until the user commits an edit (e.g.
|
||
|
|
by pressing Enter or Tab) in which case the new text is returned.
|
||
|
|
For other editors (e.g. a combobox) setContentFromEditor() is
|
||
|
|
always called so the currently display value is the one returned.
|
||
|
|
<p> <p>See also <a href="#setText">setText</a>() and <a href="#pixmap">pixmap</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="wordWrap"></a>TQTableItem::wordWrap () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if word wrap is enabled for the cell; otherwise
|
||
|
|
returns FALSE.
|
||
|
|
<p> <p>See also <a href="#setWordWrap">setWordWrap</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>
|