<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html><head><title>QTextTableCell Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
td.postheader { font-family: sans-serif }
tr.address { font-family: sans-serif }
body { background: #ffffff; color: black; }
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">  </td><td class="postheader" 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="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QTextTableCell Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1><p>The QTextTableCell class represents the properties of a cell in
a <a href="qtexttable.html">QTextTable</a>. <a href="#details">More...</a></p>
<h3>Methods</h3><ul><li><div class="fn" /><b><a href="qtexttablecell.html#QTextTableCell">__init__</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qtexttablecell.html#QTextTableCell-2">__init__</a></b> (<i>self</i>, QTextTableCell <i>o</i>)</li><li><div class="fn" />int <b><a href="qtexttablecell.html#column">column</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qtexttablecell.html#columnSpan">columnSpan</a></b> (<i>self</i>)</li><li><div class="fn" />QTextCursor <b><a href="qtexttablecell.html#firstCursorPosition">firstCursorPosition</a></b> (<i>self</i>)</li><li><div class="fn" />QTextCharFormat <b><a href="qtexttablecell.html#format">format</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qtexttablecell.html#isValid">isValid</a></b> (<i>self</i>)</li><li><div class="fn" />QTextCursor <b><a href="qtexttablecell.html#lastCursorPosition">lastCursorPosition</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qtexttablecell.html#row">row</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qtexttablecell.html#rowSpan">rowSpan</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qtexttablecell.html#setFormat">setFormat</a></b> (<i>self</i>, QTextCharFormat <i>format</i>)</li><li><div class="fn" />int <b><a href="qtexttablecell.html#tableCellFormatIndex">tableCellFormatIndex</a></b> (<i>self</i>)</li></ul><h3>Special Methods</h3><ul><li><div class="fn" />bool <b><a href="qtexttablecell.html#__eq__">__eq__</a></b> (<i>self</i>, QTextTableCell <i>other</i>)</li><li><div class="fn" />bool <b><a href="qtexttablecell.html#__ne__">__ne__</a></b> (<i>self</i>, QTextTableCell <i>other</i>)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QTextTableCell class represents the properties of a cell in
a <a href="qtexttable.html">QTextTable</a>.</p>
<p>Table cells are pieces of document structure that belong to a
table. The table orders cells into particular rows and columns;
cells can also span multiple columns and rows.</p>
<p>Cells are usually created when a table is inserted into a
document with <a href="qtextcursor.html#insertTable">QTextCursor.insertTable</a>(), but
they are also created and destroyed when a table is resized.</p>
<p>Cells contain information about their location in a table; you
can obtain the <a href="qtexttablecell.html#row">row</a>() and
<a href="qtexttablecell.html#column">column</a>() numbers of a
cell, and its <a href="qtexttablecell.html#rowSpan">rowSpan</a>()
and <a href="qtexttablecell.html#columnSpan">columnSpan</a>().</p>
<p>The <a href="qtexttablecell.html#format">format</a>() of a cell
describes the default character format of its contents. The
<a href="qtexttablecell.html#firstCursorPosition">firstCursorPosition</a>()
and <a href="qtexttablecell.html#lastCursorPosition">lastCursorPosition</a>()
functions are used to obtain the extent of the cell in the
document.</p>
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QTextTableCell" />QTextTableCell.__init__ (<i>self</i>)</h3><p>Constructs an invalid table cell.</p>
<p><b>See also</b> <a href="qtexttablecell.html#isValid">isValid</a>().</p>
<h3 class="fn"><a name="QTextTableCell-2" />QTextTableCell.__init__ (<i>self</i>, <a href="qtexttablecell.html">QTextTableCell</a> <i>o</i>)</h3><p>Copy constructor. Creates a new <a href="qtexttablecell.html">QTextTableCell</a> object based on the
<i>other</i> cell.</p>
<h3 class="fn"><a name="column" />int QTextTableCell.column (<i>self</i>)</h3><p>Returns the number of the column in the table that contains this
cell.</p>
<p><b>See also</b> <a href="qtexttablecell.html#row">row</a>().</p>
<h3 class="fn"><a name="columnSpan" />int QTextTableCell.columnSpan (<i>self</i>)</h3><p>Returns the number of columns this cell spans. The default is
1.</p>
<p><b>See also</b> <a href="qtexttablecell.html#rowSpan">rowSpan</a>().</p>
<h3 class="fn"><a name="firstCursorPosition" /><a href="qtextcursor.html">QTextCursor</a> QTextTableCell.firstCursorPosition (<i>self</i>)</h3><p>Returns the first valid cursor position in this cell.</p>
<p><b>See also</b> <a href="qtexttablecell.html#lastCursorPosition">lastCursorPosition</a>().</p>
<h3 class="fn"><a name="format" /><a href="qtextcharformat.html">QTextCharFormat</a> QTextTableCell.format (<i>self</i>)</h3><p>Returns the cell's character format.</p>
<p><b>See also</b> <a href="qtexttablecell.html#setFormat">setFormat</a>().</p>
<h3 class="fn"><a name="isValid" />bool QTextTableCell.isValid (<i>self</i>)</h3><p>Returns true if this is a valid table cell; otherwise returns
false.</p>
<h3 class="fn"><a name="lastCursorPosition" /><a href="qtextcursor.html">QTextCursor</a> QTextTableCell.lastCursorPosition (<i>self</i>)</h3><p>Returns the last valid cursor position in this cell.</p>
<p><b>See also</b> <a href="qtexttablecell.html#firstCursorPosition">firstCursorPosition</a>().</p>
<h3 class="fn"><a name="row" />int QTextTableCell.row (<i>self</i>)</h3><p>Returns the number of the row in the table that contains this
cell.</p>
<p><b>See also</b> <a href="qtexttablecell.html#column">column</a>().</p>
<h3 class="fn"><a name="rowSpan" />int QTextTableCell.rowSpan (<i>self</i>)</h3><p>Returns the number of rows this cell spans. The default is
1.</p>
<p><b>See also</b> <a href="qtexttablecell.html#columnSpan">columnSpan</a>().</p>
<h3 class="fn"><a name="setFormat" />QTextTableCell.setFormat (<i>self</i>, <a href="qtextcharformat.html">QTextCharFormat</a> <i>format</i>)</h3><p>Sets the cell's character format to <i>format</i>. This can for
example be used to change the background color of the entire
cell:</p>
<p><a href="qtexttablecell.html">QTextTableCell</a> cell =
table->cellAt(2, 3); <a href="qtextcharformat.html">QTextCharFormat</a> format = cell.<a href="qtexttablecell.html#format">format</a>();
format.setBackground(<a href="qt.html#GlobalColor-enum">Qt.blue</a>);
cell.setFormat(format);</p>
<p>Note that the cell's row or column span cannot be changed
through this function. You have to use QTextTable.mergeCells and
QTextTable.splitCell instead.</p>
<p>This function was introduced in Qt 4.2.</p>
<p><b>See also</b> <a href="qtexttablecell.html#format">format</a>().</p>
<h3 class="fn"><a name="tableCellFormatIndex" />int QTextTableCell.tableCellFormatIndex (<i>self</i>)</h3><p>Returns the index of the tableCell's format in the document's
internal list of formats.</p>
<p>This function was introduced in Qt 4.5.</p>
<p><b>See also</b> <a href="qtextdocument.html#allFormats">QTextDocument.allFormats</a>().</p>
<h3 class="fn"><a name="__eq__" />bool QTextTableCell.__eq__ (<i>self</i>, <a href="qtexttablecell.html">QTextTableCell</a> <i>other</i>)</h3><h3 class="fn"><a name="__ne__" />bool QTextTableCell.__ne__ (<i>self</i>, <a href="qtexttablecell.html">QTextTableCell</a> <i>other</i>)</h3><address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt 4.10.3 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2012</td><td align="right" width="25%">Qt 4.8.5</td></tr></table></div></address></body></html>
