<?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>