<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.5.0_09) on Tue Aug 07 17:05:12 CEST 2007 -->
<TITLE>
QTextBlock
</TITLE>
<META NAME="keywords" CONTENT="com.trolltech.qt.gui.QTextBlock class">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
parent.document.title="QTextBlock";
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../com/trolltech/qt/gui/QTabWidget.TabShape.html" title="enum in com.trolltech.qt.gui"><B>PREV CLASS</B></A>
<A HREF="../../../../com/trolltech/qt/gui/QTextBlock_iterator.html" title="class in com.trolltech.qt.gui"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?com/trolltech/qt/gui/QTextBlock.html" target="_top"><B>FRAMES</B></A>
<A HREF="QTextBlock.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: <A HREF="#nested_classes_inherited_from_class_com.trolltech.qt.QSignalEmitter">NESTED</A> | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
com.trolltech.qt.gui</FONT>
<BR>
Class QTextBlock</H2>
<PRE>
java.lang.Object
<IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../../com/trolltech/qt/QSignalEmitter.html" title="class in com.trolltech.qt">com.trolltech.qt.QSignalEmitter</A>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../../com/trolltech/qt/QtJambiObject.html" title="class in com.trolltech.qt">com.trolltech.qt.QtJambiObject</A>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>com.trolltech.qt.gui.QTextBlock</B>
</PRE>
<DL>
<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../com/trolltech/qt/QtJambiInterface.html" title="interface in com.trolltech.qt">QtJambiInterface</A>, java.lang.Comparable</DD>
</DL>
<HR>
<DL>
<DT><PRE>public class <B>QTextBlock</B><DT>extends <A HREF="../../../../com/trolltech/qt/QtJambiObject.html" title="class in com.trolltech.qt">QtJambiObject</A><DT>implements java.lang.Comparable</DL>
</PRE>
<P>
<p>The <a href="QTextBlock.html#QTextBlock(com.trolltech.qt.gui.QTextBlock)"><tt>QTextBlock</tt></a> class provides a container for text fragments in a <a href="QTextDocument.html"><tt>QTextDocument</tt></a>.</p>
<p>A text block encapsulates a block or paragraph of text in a <a href="QTextDocument.html"><tt>QTextDocument</tt></a>. <a href="QTextBlock.html#QTextBlock(com.trolltech.qt.gui.QTextBlock)"><tt>QTextBlock</tt></a> provides read-only access to the block/paragraph structure of QTextDocuments. It is mainly of use if you want to implement your own layouts for the visual representation of a <a href="QTextDocument.html"><tt>QTextDocument</tt></a>, or if you want to iterate over a document and write out the contents in your own custom format.</p>
<p>Text blocks are created by their parent documents. If you need to create a new text block, or modify the contents of a document while examining its contents, use the cursor-based interface provided by <a href="QTextCursor.html"><tt>QTextCursor</tt></a> instead.</p>
<p>Each text block is located at a specific <a href="QTextBlock.html#position()"><tt>position</tt></a> in a <a href="QTextBlock.html#document()"><tt>document</tt></a>. The contents of the block can be obtained by using the <a href="QTextBlock.html#text()"><tt>text</tt></a> function. The <a href="QTextBlock.html#length()"><tt>length</tt></a> function determines the block's size within the document (including formatting characters). The visual properties of the block are determined by its text <a href="QTextBlock.html#layout()"><tt>layout</tt></a>, its <a href="QTextBlock.html#charFormat()"><tt>charFormat</tt></a>, and its <a href="QTextBlock.html#blockFormat()"><tt>blockFormat</tt></a>.</p>
<p>The <a href="QTextBlock.html#next()"><tt>next</tt></a> and <a href="QTextBlock.html#previous()"><tt>previous</tt></a> functions enable iteration over consecutive valid blocks in a document under the condition that the document is not modified by other means during the iteration process. Note that, although blocks are returned in sequence, adjacent blocks may come from different places in the document structure. The validity of a block can be determined by calling <a href="QTextBlock.html#isValid()"><tt>isValid</tt></a>.</p>
<p><a href="QTextBlock.html#QTextBlock(com.trolltech.qt.gui.QTextBlock)"><tt>QTextBlock</tt></a> provides comparison operators to make it easier to work with blocks: <tt>operator==</tt> compares two block for equality, <tt>operator!=</tt> compares two blocks for inequality, and <tt>operator<</tt> determines whether a block precedes another in the same document.</p>
<p align="center"><img src="%2E%2E/images/qtextblock-sequence.png" /></p>
<P>
<P>
<DL>
<DT><B>See Also:</B><DD><a href="QTextBlockFormat.html"><tt>QTextBlockFormat</tt></a>,
<a href="QTextCharFormat.html"><tt>QTextCharFormat</tt></a>,
<a href="QTextFragment.html"><tt>QTextFragment</tt></a></DL>
<HR>
<P>
<!-- ======== NESTED CLASS SUMMARY ======== -->
<A NAME="nested_class_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Nested Class Summary</B></FONT></TH>
</TR>
</TABLE>
<A NAME="nested_classes_inherited_from_class_com.trolltech.qt.QSignalEmitter"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Nested classes/interfaces inherited from class com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QSignalEmitter.html" title="class in com.trolltech.qt">QSignalEmitter</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal0.html" title="class in com.trolltech.qt">QSignalEmitter.Signal0</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal1.html" title="class in com.trolltech.qt">QSignalEmitter.Signal1</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal1.html" title="type parameter in QSignalEmitter.Signal1">A</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal2.html" title="class in com.trolltech.qt">QSignalEmitter.Signal2</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal2.html" title="type parameter in QSignalEmitter.Signal2">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal2.html" title="type parameter in QSignalEmitter.Signal2">B</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="class in com.trolltech.qt">QSignalEmitter.Signal3</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="type parameter in QSignalEmitter.Signal3">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="type parameter in QSignalEmitter.Signal3">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="type parameter in QSignalEmitter.Signal3">C</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="class in com.trolltech.qt">QSignalEmitter.Signal4</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">D</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="class in com.trolltech.qt">QSignalEmitter.Signal5</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">E</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="class in com.trolltech.qt">QSignalEmitter.Signal6</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">F</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="class in com.trolltech.qt">QSignalEmitter.Signal7</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">F</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">G</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="class in com.trolltech.qt">QSignalEmitter.Signal8</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">F</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">G</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">H</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="class in com.trolltech.qt">QSignalEmitter.Signal9</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">F</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">G</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">H</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">I</A>></CODE></TD>
</TR>
</TABLE>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<A NAME="constructor_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Constructor Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#QTextBlock()">QTextBlock</A></B>()</CODE>
<BR>
This method is used internally by Qt Jambi.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#QTextBlock(com.trolltech.qt.gui.QTextBlock)">QTextBlock</A></B>(<A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html" title="class in com.trolltech.qt.gui">QTextBlock</A> o)</CODE>
<BR>
Copies the <tt>o</tt> text block's attributes to this text block.</TD>
</TR>
</TABLE>
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Method Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../com/trolltech/qt/gui/QTextBlock_iterator.html" title="class in com.trolltech.qt.gui">QTextBlock_iterator</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#begin()">begin</A></B>()</CODE>
<BR>
Returns a text block iterator pointing to the beginning of the text block.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../com/trolltech/qt/gui/QTextBlockFormat.html" title="class in com.trolltech.qt.gui">QTextBlockFormat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#blockFormat()">blockFormat</A></B>()</CODE>
<BR>
Returns the <a href="QTextBlockFormat.html"><tt>QTextBlockFormat</tt></a> that describes block-specific properties.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#blockFormatIndex()">blockFormatIndex</A></B>()</CODE>
<BR>
Returns an index into the document's internal list of block formats for the text block's format.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../com/trolltech/qt/gui/QTextCharFormat.html" title="class in com.trolltech.qt.gui">QTextCharFormat</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#charFormat()">charFormat</A></B>()</CODE>
<BR>
Returns the <a href="QTextCharFormat.html"><tt>QTextCharFormat</tt></a> that describes the block's character format.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#charFormatIndex()">charFormatIndex</A></B>()</CODE>
<BR>
Returns an index into the document's internal list of character formats for the text block's character format.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#compareTo(java.lang.Object)">compareTo</A></B>(java.lang.Object other)</CODE>
<BR>
</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#contains(int)">contains</A></B>(int position)</CODE>
<BR>
Returns true if the given <tt>position</tt> is located within the text block; otherwise returns false.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../com/trolltech/qt/gui/QTextDocument.html" title="class in com.trolltech.qt.gui">QTextDocument</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#document()">document</A></B>()</CODE>
<BR>
Returns the text document this text block belongs to, or 0 if the text block does not belong to any document.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../com/trolltech/qt/gui/QTextBlock_iterator.html" title="class in com.trolltech.qt.gui">QTextBlock_iterator</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#end()">end</A></B>()</CODE>
<BR>
Returns a text block iterator pointing to the end of the text block.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#equals(java.lang.Object)">equals</A></B>(java.lang.Object other)</CODE>
<BR>
</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static <A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html" title="class in com.trolltech.qt.gui">QTextBlock</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#fromNativePointer(com.trolltech.qt.QNativePointer)">fromNativePointer</A></B>(<A HREF="../../../../com/trolltech/qt/QNativePointer.html" title="class in com.trolltech.qt">QNativePointer</A> nativePointer)</CODE>
<BR>
This function returns the QTextBlock instance pointed to by nativePointer</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#isValid()">isValid</A></B>()</CODE>
<BR>
Returns true if this text block is valid; otherwise returns false.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../com/trolltech/qt/gui/QTextLayout.html" title="class in com.trolltech.qt.gui">QTextLayout</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#layout()">layout</A></B>()</CODE>
<BR>
Returns the <a href="QTextLayout.html"><tt>QTextLayout</tt></a> that is used to lay out and display the block's contents.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#length()">length</A></B>()</CODE>
<BR>
Returns the length of the block in characters.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static <A HREF="../../../../com/trolltech/qt/QNativePointer.html" title="class in com.trolltech.qt">QNativePointer</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#nativePointerArray(com.trolltech.qt.gui.QTextBlock[])">nativePointerArray</A></B>(<A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html" title="class in com.trolltech.qt.gui">QTextBlock</A>[] array)</CODE>
<BR>
This function returns a QNativePointer that is pointing to the specified QTextBlock array.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html" title="class in com.trolltech.qt.gui">QTextBlock</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#next()">next</A></B>()</CODE>
<BR>
Returns the text block in the document after this block, or an empty text block if this is the last one.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#position()">position</A></B>()</CODE>
<BR>
Returns the index of the block's first character within the document.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html" title="class in com.trolltech.qt.gui">QTextBlock</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#previous()">previous</A></B>()</CODE>
<BR>
Returns the text block in the document before this block, or an empty text block if this is the first one.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#setUserData(com.trolltech.qt.gui.QTextBlockUserData)">setUserData</A></B>(<A HREF="../../../../com/trolltech/qt/gui/QTextBlockUserData.html" title="class in com.trolltech.qt.gui">QTextBlockUserData</A> data)</CODE>
<BR>
Attaches the given <tt>data</tt> object to the text block.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#setUserState(int)">setUserState</A></B>(int state)</CODE>
<BR>
Stores the specified <tt>state</tt> integer value in the text block.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#text()">text</A></B>()</CODE>
<BR>
Returns the block's contents as plain text.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../com/trolltech/qt/gui/QTextList.html" title="class in com.trolltech.qt.gui">QTextList</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#textList()">textList</A></B>()</CODE>
<BR>
If the block represents a list item, returns the list that the item belongs to; otherwise returns 0.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../com/trolltech/qt/gui/QTextBlockUserData.html" title="class in com.trolltech.qt.gui">QTextBlockUserData</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#userData()">userData</A></B>()</CODE>
<BR>
Returns a pointer to a <a href="QTextBlockUserData.html"><tt>QTextBlockUserData</tt></a> object if previously set with <a href="QTextBlock.html#setUserData(com.trolltech.qt.gui.QTextBlockUserData)"><tt>setUserData</tt></a> or a null pointer.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html#userState()">userState</A></B>()</CODE>
<BR>
Returns the integer value previously set with <a href="QTextBlock.html#setUserState(int)"><tt>setUserState</tt></a> or -1.</TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_com.trolltech.qt.QtJambiObject"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QtJambiObject.html" title="class in com.trolltech.qt">QtJambiObject</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../../com/trolltech/qt/QtJambiObject.html#dispose()">dispose</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#disposed()">disposed</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#finalize()">finalize</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#reassignNativeResources(com.trolltech.qt.QtJambiObject, java.lang.Class)">reassignNativeResources</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#tr(java.lang.String)">tr</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#tr(java.lang.String, java.lang.String)">tr</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#tr(java.lang.String, java.lang.String, int)">tr</A></CODE></TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_com.trolltech.qt.QSignalEmitter"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QSignalEmitter.html" title="class in com.trolltech.qt">QSignalEmitter</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#blockSignals(boolean)">blockSignals</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#disconnect()">disconnect</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#disconnect(java.lang.Object)">disconnect</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#signalsBlocked()">signalsBlocked</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#signalSender()">signalSender</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#thread()">thread</A></CODE></TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_com.trolltech.qt.QtJambiInterface"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from interface com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QtJambiInterface.html" title="interface in com.trolltech.qt">QtJambiInterface</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#disableGarbageCollection()">disableGarbageCollection</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#nativeId()">nativeId</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#nativePointer()">nativePointer</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#reenableGarbageCollection()">reenableGarbageCollection</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#setJavaOwnership()">setJavaOwnership</A></CODE></TD>
</TR>
</TABLE>
<P>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="QTextBlock()"><!-- --></A><H3>
QTextBlock</H3>
<PRE>
public <B>QTextBlock</B>()</PRE>
<DL>
<DD><p>This method is used internally by Qt Jambi.
Do not use it in your applications.</p>
<P>
</DL>
<HR>
<A NAME="QTextBlock(com.trolltech.qt.gui.QTextBlock)"><!-- --></A><H3>
QTextBlock</H3>
<PRE>
public <B>QTextBlock</B>(<A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html" title="class in com.trolltech.qt.gui">QTextBlock</A> o)</PRE>
<DL>
<DD><p>Copies the <tt>o</tt> text block's attributes to this text block.</p>
<P>
</DL>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="begin()"><!-- --></A><H3>
begin</H3>
<PRE>
public final <A HREF="../../../../com/trolltech/qt/gui/QTextBlock_iterator.html" title="class in com.trolltech.qt.gui">QTextBlock_iterator</A> <B>begin</B>()</PRE>
<DL>
<DD><p>Returns a text block iterator pointing to the beginning of the text block.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#end()"><tt>end</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="blockFormat()"><!-- --></A><H3>
blockFormat</H3>
<PRE>
public final <A HREF="../../../../com/trolltech/qt/gui/QTextBlockFormat.html" title="class in com.trolltech.qt.gui">QTextBlockFormat</A> <B>blockFormat</B>()</PRE>
<DL>
<DD><p>Returns the <a href="QTextBlockFormat.html"><tt>QTextBlockFormat</tt></a> that describes block-specific properties.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#charFormat()"><tt>charFormat</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="blockFormatIndex()"><!-- --></A><H3>
blockFormatIndex</H3>
<PRE>
public final int <B>blockFormatIndex</B>()</PRE>
<DL>
<DD><p>Returns an index into the document's internal list of block formats for the text block's format.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><tt>QTextDocument::object</tt></DL>
</DD>
</DL>
<HR>
<A NAME="charFormat()"><!-- --></A><H3>
charFormat</H3>
<PRE>
public final <A HREF="../../../../com/trolltech/qt/gui/QTextCharFormat.html" title="class in com.trolltech.qt.gui">QTextCharFormat</A> <B>charFormat</B>()</PRE>
<DL>
<DD><p>Returns the <a href="QTextCharFormat.html"><tt>QTextCharFormat</tt></a> that describes the block's character format. The block's character format is used when inserting text into an empty block.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#blockFormat()"><tt>blockFormat</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="charFormatIndex()"><!-- --></A><H3>
charFormatIndex</H3>
<PRE>
public final int <B>charFormatIndex</B>()</PRE>
<DL>
<DD><p>Returns an index into the document's internal list of character formats for the text block's character format.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><tt>QTextDocument::object</tt></DL>
</DD>
</DL>
<HR>
<A NAME="contains(int)"><!-- --></A><H3>
contains</H3>
<PRE>
public final boolean <B>contains</B>(int position)</PRE>
<DL>
<DD><p>Returns true if the given <tt>position</tt> is located within the text block; otherwise returns false.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="document()"><!-- --></A><H3>
document</H3>
<PRE>
public final <A HREF="../../../../com/trolltech/qt/gui/QTextDocument.html" title="class in com.trolltech.qt.gui">QTextDocument</A> <B>document</B>()</PRE>
<DL>
<DD><p>Returns the text document this text block belongs to, or 0 if the text block does not belong to any document.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="end()"><!-- --></A><H3>
end</H3>
<PRE>
public final <A HREF="../../../../com/trolltech/qt/gui/QTextBlock_iterator.html" title="class in com.trolltech.qt.gui">QTextBlock_iterator</A> <B>end</B>()</PRE>
<DL>
<DD><p>Returns a text block iterator pointing to the end of the text block.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#begin()"><tt>begin</tt></a>,
<a href="QTextBlock.html#next()"><tt>next</tt></a>,
<a href="QTextBlock.html#previous()"><tt>previous</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="isValid()"><!-- --></A><H3>
isValid</H3>
<PRE>
public final boolean <B>isValid</B>()</PRE>
<DL>
<DD><p>Returns true if this text block is valid; otherwise returns false.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="layout()"><!-- --></A><H3>
layout</H3>
<PRE>
public final <A HREF="../../../../com/trolltech/qt/gui/QTextLayout.html" title="class in com.trolltech.qt.gui">QTextLayout</A> <B>layout</B>()</PRE>
<DL>
<DD><p>Returns the <a href="QTextLayout.html"><tt>QTextLayout</tt></a> that is used to lay out and display the block's contents.</p>
<p>Note that the returned <a href="QTextLayout.html"><tt>QTextLayout</tt></a> object can only be modified from the documentChanged implementation of a <a href="QAbstractTextDocumentLayout.html"><tt>QAbstractTextDocumentLayout</tt></a> subclass. Any changes applied from the outside cause undefined behavior.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="length()"><!-- --></A><H3>
length</H3>
<PRE>
public final int <B>length</B>()</PRE>
<DL>
<DD><p>Returns the length of the block in characters.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#text()"><tt>text</tt></a>,
<a href="QTextBlock.html#charFormat()"><tt>charFormat</tt></a>,
<a href="QTextBlock.html#blockFormat()"><tt>blockFormat</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="next()"><!-- --></A><H3>
next</H3>
<PRE>
public final <A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html" title="class in com.trolltech.qt.gui">QTextBlock</A> <B>next</B>()</PRE>
<DL>
<DD><p>Returns the text block in the document after this block, or an empty text block if this is the last one.</p>
<p>Note that the next block may be in a different frame or table to this block.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#previous()"><tt>previous</tt></a>,
<a href="QTextBlock.html#begin()"><tt>begin</tt></a>,
<a href="QTextBlock.html#end()"><tt>end</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="position()"><!-- --></A><H3>
position</H3>
<PRE>
public final int <B>position</B>()</PRE>
<DL>
<DD><p>Returns the index of the block's first character within the document.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="previous()"><!-- --></A><H3>
previous</H3>
<PRE>
public final <A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html" title="class in com.trolltech.qt.gui">QTextBlock</A> <B>previous</B>()</PRE>
<DL>
<DD><p>Returns the text block in the document before this block, or an empty text block if this is the first one.</p>
<p>Note that the next block may be in a different frame or table to this block.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#next()"><tt>next</tt></a>,
<a href="QTextBlock.html#begin()"><tt>begin</tt></a>,
<a href="QTextBlock.html#end()"><tt>end</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="setUserData(com.trolltech.qt.gui.QTextBlockUserData)"><!-- --></A><H3>
setUserData</H3>
<PRE>
public final void <B>setUserData</B>(<A HREF="../../../../com/trolltech/qt/gui/QTextBlockUserData.html" title="class in com.trolltech.qt.gui">QTextBlockUserData</A> data)</PRE>
<DL>
<DD><p>Attaches the given <tt>data</tt> object to the text block.</p>
<p><a href="QTextBlockUserData.html"><tt>QTextBlockUserData</tt></a> can be used to store custom settings. The ownership is passed to the underlying text document, i.e. the provided <a href="QTextBlockUserData.html"><tt>QTextBlockUserData</tt></a> object will be deleted if the corresponding text block gets deleted. The user data object is not stored in the undo history, so it will not be available after undoing the deletion of a text block.</p>
<p>For example, if you write a programming editor in an IDE, you may want to let your user set breakpoints visually in your code for an integrated debugger. In a programming editor a line of text usually corresponds to one <a href="QTextBlock.html#QTextBlock(com.trolltech.qt.gui.QTextBlock)"><tt>QTextBlock</tt></a>. The <a href="QTextBlockUserData.html"><tt>QTextBlockUserData</tt></a> interface allows the developer to store data for each <a href="QTextBlock.html#QTextBlock(com.trolltech.qt.gui.QTextBlock)"><tt>QTextBlock</tt></a>, like for example in which lines of the source code the user has a breakpoint set. Of course this could also be stored externally, but by storing it inside the <a href="QTextDocument.html"><tt>QTextDocument</tt></a>, it will for example be automatically deleted when the user deletes the associated line. It's really just a way to store custom information in the <a href="QTextDocument.html"><tt>QTextDocument</tt></a> without using custom properties in <a href="QTextFormat.html"><tt>QTextFormat</tt></a> which would affect the undo/redo stack.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#userData()"><tt>userData</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="setUserState(int)"><!-- --></A><H3>
setUserState</H3>
<PRE>
public final void <B>setUserState</B>(int state)</PRE>
<DL>
<DD><p>Stores the specified <tt>state</tt> integer value in the text block. This may be useful for example in a syntax highlighter to store a text parsing state.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#userState()"><tt>userState</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="text()"><!-- --></A><H3>
text</H3>
<PRE>
public final java.lang.String <B>text</B>()</PRE>
<DL>
<DD><p>Returns the block's contents as plain text.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#length()"><tt>length</tt></a>,
<a href="QTextBlock.html#charFormat()"><tt>charFormat</tt></a>,
<a href="QTextBlock.html#blockFormat()"><tt>blockFormat</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="textList()"><!-- --></A><H3>
textList</H3>
<PRE>
public final <A HREF="../../../../com/trolltech/qt/gui/QTextList.html" title="class in com.trolltech.qt.gui">QTextList</A> <B>textList</B>()</PRE>
<DL>
<DD><p>If the block represents a list item, returns the list that the item belongs to; otherwise returns 0.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="userData()"><!-- --></A><H3>
userData</H3>
<PRE>
public final <A HREF="../../../../com/trolltech/qt/gui/QTextBlockUserData.html" title="class in com.trolltech.qt.gui">QTextBlockUserData</A> <B>userData</B>()</PRE>
<DL>
<DD><p>Returns a pointer to a <a href="QTextBlockUserData.html"><tt>QTextBlockUserData</tt></a> object if previously set with <a href="QTextBlock.html#setUserData(com.trolltech.qt.gui.QTextBlockUserData)"><tt>setUserData</tt></a> or a null pointer.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#setUserData(com.trolltech.qt.gui.QTextBlockUserData)"><tt>setUserData</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="userState()"><!-- --></A><H3>
userState</H3>
<PRE>
public final int <B>userState</B>()</PRE>
<DL>
<DD><p>Returns the integer value previously set with <a href="QTextBlock.html#setUserState(int)"><tt>setUserState</tt></a> or -1.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><a href="QTextBlock.html#setUserState(int)"><tt>setUserState</tt></a></DL>
</DD>
</DL>
<HR>
<A NAME="fromNativePointer(com.trolltech.qt.QNativePointer)"><!-- --></A><H3>
fromNativePointer</H3>
<PRE>
public static <A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html" title="class in com.trolltech.qt.gui">QTextBlock</A> <B>fromNativePointer</B>(<A HREF="../../../../com/trolltech/qt/QNativePointer.html" title="class in com.trolltech.qt">QNativePointer</A> nativePointer)</PRE>
<DL>
<DD>This function returns the QTextBlock instance pointed to by nativePointer
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>nativePointer</CODE> - the QNativePointer of which object should be returned.</DL>
</DD>
</DL>
<HR>
<A NAME="nativePointerArray(com.trolltech.qt.gui.QTextBlock[])"><!-- --></A><H3>
nativePointerArray</H3>
<PRE>
public static <A HREF="../../../../com/trolltech/qt/QNativePointer.html" title="class in com.trolltech.qt">QNativePointer</A> <B>nativePointerArray</B>(<A HREF="../../../../com/trolltech/qt/gui/QTextBlock.html" title="class in com.trolltech.qt.gui">QTextBlock</A>[] array)</PRE>
<DL>
<DD>This function returns a QNativePointer that is pointing to the specified QTextBlock array.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>array</CODE> - the array that the returned pointer will point to.
<DT><B>Returns:</B><DD>a QNativePointer that is pointing to the specified array.</DL>
</DD>
</DL>
<HR>
<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
public boolean <B>equals</B>(java.lang.Object other)</PRE>
<DL>
<DD>
<P>
<DD><DL>
<DT><B>Overrides:</B><DD><CODE>equals</CODE> in class <CODE>java.lang.Object</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="compareTo(java.lang.Object)"><!-- --></A><H3>
compareTo</H3>
<PRE>
public int <B>compareTo</B>(java.lang.Object other)</PRE>
<DL>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>compareTo</CODE> in interface <CODE>java.lang.Comparable</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../com/trolltech/qt/gui/QTabWidget.TabShape.html" title="enum in com.trolltech.qt.gui"><B>PREV CLASS</B></A>
<A HREF="../../../../com/trolltech/qt/gui/QTextBlock_iterator.html" title="class in com.trolltech.qt.gui"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?com/trolltech/qt/gui/QTextBlock.html" target="_top"><B>FRAMES</B></A>
<A HREF="QTextBlock.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: <A HREF="#nested_classes_inherited_from_class_com.trolltech.qt.QSignalEmitter">NESTED</A> | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<HR>
</BODY>
</HTML>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
a6711891ce757817bba854bf3f25205a
>
files
>
891
