qtextedit.html

QT参考文档

<h3 class=fn>void <a name="append"></a>QTextEdit::append ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;text )<tt> [虚 槽]</tt>
</h3> 
把文本<em>text</em>添加到文本编辑的结尾。注意这个函数会清空撤销/恢复历史。
<p>实例：<a href="clientserver-example.html#x790">network/clientserver/client/client.cpp</a>、<a href="clientserver-example.html#x772">network/clientserver/server/server.cpp</a>、<a href="httpd-example.html#x646">network/httpd/httpd.cpp</a>和<a href="process-example.html#x71">process/process.cpp</a>。

<h3 class=fn>bool <a name="bold"></a>QTextEdit::bold () const
</h3>
如果当前格式是粗体的，返回真，否则返回假。
<p> <p>也可以参考<a href="#setBold">setBold</a>()。

<h3 class=fn>int <a name="charAt"></a>QTextEdit::charAt ( const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos, int&nbsp;*&nbsp;para ) const
</h3>
返回在<em>pos</em>位置（在内容坐标中）的字符的索引（相对于它的段落）。如果<em>para</em>不为零，<em>*</em><em>para</em>被设置为当前段落。如果在<em>pos</em>没有字符，-1被返回。

<h3 class=fn>void <a name="clear"></a>QTextEdit::clear ()<tt> [虚 槽]</tt>
</h3>
删除文本编辑中的所有文本。
<p> <p>也可以参考<a href="#cut">cut</a>(), <a href="#removeSelectedText">removeSelectedText</a>()和<a href="#text-prop">text</a>。

<h3 class=fn>void <a name="clearParagraphBackground"></a>QTextEdit::clearParagraphBackground ( int&nbsp;para )<tt> [虚 槽]</tt>
</h3> 
清除<em>para</em>段落的背景色，所以背景色将再次被使用。

<h3 class=fn><a href="qcolor.html">QColor</a> <a name="color"></a>QTextEdit::color () const
</h3>
返回当前格式的颜色。
<p> <p>也可以参考<a href="#setColor">setColor</a>()和<a href="#paper-prop">paper</a>。

<h3 class=fn><a href="qstring.html">QString</a> <a name="context"></a>QTextEdit::context () const
</h3>  
返回编辑的context。context是文本编辑的<a href="qmimesourcefactory.html">QMimeSourceFactory</a>用来解析文件和图片的定位的路径。
<p> <p>也可以参考<a href="#text-prop">text</a>。
<p>实例：<a href="helpviewer-example.html#x1030">helpviewer/helpwindow.cpp</a>和<a href="qdir-example.html#x1836">qdir/qdir.cpp</a>。

<h3 class=fn>void <a name="copy"></a>QTextEdit::copy ()<tt> [虚 槽]</tt>
</h3> 
复制任何选择文本（从选择区0中）到剪贴板。
<p> <p>也可以参考<a href="#hasSelectedText-prop">hasSelectedText</a>和<a href="#copyAvailable">copyAvailable</a>()。

<h3 class=fn>void <a name="copyAvailable"></a>QTextEdit::copyAvailable ( bool&nbsp;yes )<tt> [信号]</tt>
</h3>  
<p> 当文本编辑中的文本被选择或者取消选择时，这个信号被发射。
<p> 当文本被选择时，这个信号被发射，这时<em>yes</em>被设置为真。如果没有文本被选择或者如果被选择文本被取消选择，这个信号被发射，这时<em>yes</em>被设置为假。
<p> 如果<em>yes</em>为真，那么<a href="#copy">copy</a>()可以被用来复制所选文本到剪贴板。如果<em>yes</em>为假，那么copy()什么也不做。
<p> <p>也可以参考<a href="#selectionChanged">selectionChanged</a>()。

<h3 class=fn><a href="qpopupmenu.html">QPopupMenu</a>&nbsp;* <a name="createPopupMenu"></a>QTextEdit::createPopupMenu ( const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos )<tt> [虚 保护]</tt>
</h3>
<p> 这个函数被用来在文档<em>pos</em>位置创建一个右键弹出菜单。如果你想创建一个自定义弹出菜单，重新实现这个函数并且返回被创建的弹出菜单。弹出菜单的所有权被传递给调用者。

<h3 class=fn><a href="qpopupmenu.html">QPopupMenu</a>&nbsp;* <a name="createPopupMenu-2"></a>QTextEdit::createPopupMenu ()<tt> [虚 保护]</tt>
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 这个函数被用来创建一个右键弹出菜单。如果你想创建一个自定义弹出菜单，重新实现这个函数并且返回被创建的弹出菜单。弹出菜单的所有权被传递给调用者。
<p> 这个函数只有在<a href="#createPopupMenu">createPopupMenu</a>( const <a href="qpoint.html">QPoint</a> & )返回0时才能被调用。

<h3 class=fn>void <a name="currentAlignmentChanged"></a>QTextEdit::currentAlignmentChanged ( int&nbsp;a )<tt> [信号]</tt>
</h3> 
<p> 如果当前段落的对齐方式已经改变时，这个信号被发射。
<p> 新的对齐方式是<em>a</em>。
<p> <p>也可以参考<a href="#setAlignment">setAlignment</a>()。

<h3 class=fn>void <a name="currentColorChanged"></a>QTextEdit::currentColorChanged ( const&nbsp;<a href="qcolor.html">QColor</a>&nbsp;&amp;&nbsp;c )<tt> [信号]</tt>
</h3> 
<p> 如果当前格式的颜色已经改变时，这个信号被发射。
<p> 新的颜色是<em>c</em>。
<p> <p>也可以参考<a href="#setColor">setColor</a>()。

<h3 class=fn>void <a name="currentFontChanged"></a>QTextEdit::currentFontChanged ( const&nbsp;<a href="qfont.html">QFont</a>&nbsp;&amp;&nbsp;f )<tt> [信号]</tt>
</h3> 
<p> 如果当前格式的字体已经改变时，这个信号被发射。
<p> 新的字体是<em>f</em>。
<p> <p>也可以参考<a href="#setCurrentFont">setCurrentFont</a>()。

<h3 class=fn>void <a name="currentVerticalAlignmentChanged"></a>QTextEdit::currentVerticalAlignmentChanged ( <a href="qtextedit.html#VerticalAlignment-enum">VerticalAlignment</a>&nbsp;a )<tt> [信号]</tt>
</h3> 
<p> 如果当前格式的垂直对齐方式已经改变时，这个信号被发射。
<p> 新的垂直对齐方式是<em>a</em>。
<p> <p>也可以参考<a href="#setVerticalAlignment">setVerticalAlignment</a>()。

<h3 class=fn>void <a name="cursorPositionChanged"></a>QTextEdit::cursorPositionChanged ( QTextCursor&nbsp;*&nbsp;c )<tt> [信号]</tt>
</h3> 
<p> 如果光标位置发生改变，这个信号被发射。<em>c</em>指向文本光标对象。
<p> <p>也可以参考<a href="#setCursorPosition">setCursorPosition</a>()。

<h3 class=fn>void <a name="cursorPositionChanged-2"></a>QTextEdit::cursorPositionChanged ( int&nbsp;para, int&nbsp;pos )<tt> [信号]</tt>
</h3> 
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 如果光标位置发生改变，这个信号被发射。<em>para</em>包含段落索引并且<em>pos</em>包含段落中的字符位置。
<p> <p>也可以参考<a href="#setCursorPosition">setCursorPosition</a>()。

<h3 class=fn>void <a name="cut"></a>QTextEdit::cut ()<tt> [虚 槽]</tt>
</h3>
复制被选择文本（从选择区0中）到剪贴板并且从文本编辑中删除它。
<p> 如果没有被选择文本（在选择区0中），就什么也不发生。
<p> <p>也可以参考<a href="#copy">QTextEdit::copy</a>(), <a href="#paste">paste</a>()和<a href="#pasteSubType">pasteSubType</a>()。

<h3 class=fn>void <a name="del"></a>QTextEdit::del ()<tt> [虚 槽]</tt>
</h3>
如果有被选择文本（在选择区0中），它就被删除。如果没有被选择文本（在选择区0中），文本光标右面的字符被删除。
<p> <p>也可以参考<a href="#removeSelectedText">removeSelectedText</a>()和<a href="#cut">cut</a>()。

<h3 class=fn>void <a name="doKeyboardAction"></a>QTextEdit::doKeyboardAction ( <a href="qtextedit.html#KeyboardAction-enum">KeyboardAction</a>&nbsp;action )<tt> [虚 槽]</tt>
</h3>
执行键盘操作<em>action</em>。这通常被键盘事件处理器调用。

<h3 class=fn><a href="qstring.html">QString</a> <a name="documentTitle"></a>QTextEdit::documentTitle () const
</h3>
<p>返回从文本中解析的文档标题。详细情况请参考<a href="qtextedit.html#documentTitle-prop">“documentTitle”</a>属性。

<h3 class=fn>void <a name="ensureCursorVisible"></a>QTextEdit::ensureCursorVisible ()<tt> [虚 槽]</tt>
</h3>
如果需要，确保滚动文本编辑时光标是可视的。
<p> <p>也可以参考<a href="#setCursorPosition">setCursorPosition</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="family"></a>QTextEdit::family () const
</h3>
返回当前格式的字体族。
<p> <p>也可以参考<a href="#setFamily">setFamily</a>(), <a href="#setCurrentFont">setCurrentFont</a>()和<a href="#setPointSize">setPointSize</a>()。

<h3 class=fn>bool <a name="find"></a>QTextEdit::find ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;expr, bool&nbsp;cs, bool&nbsp;wo, bool&nbsp;forward = TRUE, int&nbsp;*&nbsp;para = 0, int&nbsp;*&nbsp;index = 0 )<tt> [虚]</tt>
</h3>
找到字符串<em>expr</em>下一个出现位置。如果<em>expr</em>被找到，返回真，否则返回假。
<p> 如果<em>para</em>和<em>index</em>都为零，搜索将从当前光标位置开始。如果<em>para</em>和<em>index</em>全不为零，搜索将从<em>*</em><em>para</em>段的<em>*</em><em>index</em>字符位置开始。
<p> 如果<em>cs</em>为真，搜索是区分大小写的，否则它是不区分大小写的。如果<em>wo</em>为真，搜索将查找匹配整个单字的，否则它搜索任何匹配的文本。如果<em>forward</em>为真（默认），搜索将从开始位置到文尾进行工作，否则它从开始位置到文首进行工作。
<p> 如果<em>expr</em>被找到，函数返回真。如果<em>index</em>和<em>para</em>不为零，被找到的匹配项的第一个字符的段落号被放到<em>*</em><em>para</em>，并且这个字符在段落中的索引位置被放到<em>*</em><em>index</em>。
<p> 如果<em>expr</em>没有被找到，函数返回假。如果<em>index</em>和<em>para</em>不为零，并且<em>expr</em>没有被找到，<em>*</em><em>index</em>和<em>*</em><em>para</em>都是不确定的。

<h3 class=fn>bool <a name="focusNextPrevChild"></a>QTextEdit::focusNextPrevChild ( bool&nbsp;n )<tt> [虚 保护]</tt>
</h3> 
重新实现用来允许链接间移动焦点。如果<em>n</em>为真，tab把焦点移动到下一个子对象，如果<em>n</em>为假，tab把焦点移动到上一个子对象。如果焦点被移动，返回真，否则返回假。

<h3 class=fn><a href="qfont.html">QFont</a> <a name="font"></a>QTextEdit::font () const
</h3>
返回当前格式的字体。
<p> <p>也可以参考<a href="#setCurrentFont">setCurrentFont</a>(), <a href="#setFamily">setFamily</a>()和<a href="#setPointSize">setPointSize</a>()。
<p>实例：<a href="qaction-application-example.html#x1089">action/application.cpp</a>、<a href="simple-application-example.html#x1534">application/application.cpp</a>、<a href="mdi-example.html#x2040">mdi/application.cpp</a>和<a href="qwerty-example.html#x394">qwerty/qwerty.cpp</a>。

<h3 class=fn>void <a name="getCursorPosition"></a>QTextEdit::getCursorPosition ( int&nbsp;*&nbsp;para, int&nbsp;*&nbsp;index ) const
</h3>