<class name="QTextTableCell" doc="/** <p>The <a href="QTextTableCell.html#QTextTableCell(com.trolltech.qt.gui.QTextTableCell)"><tt>QTextTableCell</tt></a> class represents the properties of a cell in a <a href="QTextTable.html"><tt>QTextTable</tt></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 QTextCursor::insertTable(), 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()"><tt>row</tt></a> and <a href="QTextTableCell.html#column()"><tt>column</tt></a> numbers of a cell, and its <a href="QTextTableCell.html#rowSpan()"><tt>rowSpan</tt></a> and <a href="QTextTableCell.html#columnSpan()"><tt>columnSpan</tt></a>.</p> <p>The <a href="QTextTableCell.html#format()"><tt>format</tt></a> of a cell describes the default character format of its contents. The <a href="QTextTableCell.html#firstCursorPosition()"><tt>firstCursorPosition</tt></a> and <a href="QTextTableCell.html#lastCursorPosition()"><tt>lastCursorPosition</tt></a> functions are used to obtain the extent of the cell in the document.</p> @see <a href="QTextTable.html"><tt>QTextTable</tt></a> @see <a href="QTextTableFormat.html"><tt>QTextTableFormat</tt></a> */"> <method name="public QTextTableCell()" doc="/** <p>Constructs an invalid table cell.</p> @see <a href="QTextTableCell.html#isValid()"><tt>isValid</tt></a> */"/> <method name="public QTextTableCell(com.trolltech.qt.gui.QTextTableCell o)" doc="/** <p>Copy constructor. Creates a new <a href="QTextTableCell.html#QTextTableCell(com.trolltech.qt.gui.QTextTableCell)"><tt>QTextTableCell</tt></a> object based on the <tt>o</tt> cell.</p> */"/> <method name="public final com.trolltech.qt.gui.QTextFrame_iterator begin()" doc="/** <p>Returns a frame iterator pointing to the beginning of the table's cell.</p> @see <a href="QTextTableCell.html#end()"><tt>end</tt></a> */"/> <method name="public final int column()" doc="/** <p>Returns the number of the column in the table that contains this cell.</p> @see <a href="QTextTableCell.html#row()"><tt>row</tt></a> */"/> <method name="public final int columnSpan()" doc="/** <p>Returns the number of columns this cell spans. The default is 1.</p> @see <a href="QTextTableCell.html#rowSpan()"><tt>rowSpan</tt></a> */"/> <method name="public final com.trolltech.qt.gui.QTextFrame_iterator end()" doc="/** <p>Returns a frame iterator pointing to the end of the table's cell.</p> @see <a href="QTextTableCell.html#begin()"><tt>begin</tt></a> */"/> <method name="public final com.trolltech.qt.gui.QTextCursor firstCursorPosition()" doc="/** <p>Returns the first valid cursor position in this cell.</p> @see <a href="QTextTableCell.html#lastCursorPosition()"><tt>lastCursorPosition</tt></a> */"/> <method name="public final int firstPosition()" doc="/** <p>This method is used internally by Qt Jambi. Do not use it in your applications.</p> */"/> <method name="public final com.trolltech.qt.gui.QTextCharFormat format()" doc="/** <p>Returns the cell's character format.</p> @see <a href="QTextTableCell.html#setFormat(com.trolltech.qt.gui.QTextCharFormat)"><tt>setFormat</tt></a> */"/> <method name="public final boolean isValid()" doc="/** <p>Returns true if this is a valid table cell; otherwise returns false.</p> */"/> <method name="public final com.trolltech.qt.gui.QTextCursor lastCursorPosition()" doc="/** <p>Returns the last valid cursor position in this cell.</p> @see <a href="QTextTableCell.html#firstCursorPosition()"><tt>firstCursorPosition</tt></a> */"/> <method name="public final int lastPosition()" doc="/** <p>This method is used internally by Qt Jambi. Do not use it in your applications.</p> */"/> <method name="public final int row()" doc="/** <p>Returns the number of the row in the table that contains this cell.</p> @see <a href="QTextTableCell.html#column()"><tt>column</tt></a> */"/> <method name="public final int rowSpan()" doc="/** <p>Returns the number of rows this cell spans. The default is 1.</p> @see <a href="QTextTableCell.html#columnSpan()"><tt>columnSpan</tt></a> */"/> <method name="public final void setFormat(com.trolltech.qt.gui.QTextCharFormat format)" doc="/** <p>Sets the cell's character format to <tt>format</tt>. This can for example be used to change the background color of the entire cell:</p> <p><a href="QTextTableCell.html#QTextTableCell(com.trolltech.qt.gui.QTextTableCell)"><tt>QTextTableCell</tt></a> cell = table-&gt;cellAt(2, 3); <a href="QTextCharFormat.html"><tt>QTextCharFormat</tt></a> format = cell.<a href="QTextTableCell.html#format()"><tt>format</tt></a>; format.setBackground(Qt::blue); cell.<a href="QTextTableCell.html#setFormat(com.trolltech.qt.gui.QTextCharFormat)"><tt>setFormat</tt></a>(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> @see <a href="QTextTableCell.html#format()"><tt>format</tt></a> */"/> </class>