qtextedit.html

QT参考文档

<p> 只读的QTextEdit提供了和（废弃的）QTextEdit相同的功能。（QTextView仍被提供用来保证旧代码的兼容性。）
<p> <h4> 只读的键绑定
</h4>
<a name="1-1-1"></a><p> 当QTextEdit被使用的时候，只读的键绑定仅限于浏览，并且文本只能被鼠标选定：
<center><table cellpadding="4" cellspacing="2" border="0">
<tr bgcolor="#a2c511"> <th valign="top">按键 <th valign="top">操作
<tr bgcolor="#d0d0d0"> <td valign="top"><em>UpArrow</em> <td valign="top">向上移动一行
<tr bgcolor="#f0f0f0"> <td valign="top"><em>DownArrow</em> <td valign="top">向下移动一行
<tr bgcolor="#d0d0d0"> <td valign="top"><em>LeftArrow</em> <td valign="top">向左移动一个字符
<tr bgcolor="#f0f0f0"> <td valign="top"><em>RightArrow</em> <td valign="top">向右移动一个字符
<tr bgcolor="#d0d0d0"> <td valign="top"><em>PageUp</em> <td valign="top">向上移动一页（视口）
<tr bgcolor="#f0f0f0"> <td valign="top"><em>PageDown</em> <td valign="top">向下移动一页（视口）
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Home</em> <td valign="top">移动到文本开始处
<tr bgcolor="#f0f0f0"> <td valign="top"><em>End</em> <td valign="top">移动到文本结束处
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Shift+Wheel</em> <td valign="top">水平的滚动文本（Wheel就是鼠标滚轮）
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+Wheel</em> <td valign="top">缩放文本
</table></center>
<p> 文本编辑也可以提供一些元信息。例如，<a href="#documentTitle">documentTitle</a>()函数将返回来自HTML的<tt>&lt;title&gt;</tt>标签中的文本。
<p> 文本编辑中显示的文本有一个<em>context</em>。context就是文本编辑的<a href="qmimesourcefactory.html">QMimeSourceFactory</a>用来解析文件和图片的定位的路径。当查询数据时，它被传递给<a href="#mimeSourceFactory">mimeSourceFactory</a>()。（请参考See QTextEdit()和<a href="#context">context</a>()。）
<p> <h3> 使用QTextEdit作为一个编辑器
</h3>
<a name="1-2"></a><p> 使用QTextEdit作为显示窗口部件的所有信息这里也适用。
<p> 当前格式属性可以通过<a href="#setItalic">setItalic</a>()、<a href="#setBold">setBold</a>()、<a href="#setUnderline">setUnderline</a>()、<a href="#setFamily">setFamily</a>()（字体族）、<a href="#setPointSize">setPointSize</a>()、<a href="#setColor">setColor</a>()和<a href="#setCurrentFont">setCurrentFont</a>()来设置。当前段落的对齐方式使用<a href="#setAlignment">setAlignment</a>()来设置。
<p> 使用<a href="#setSelection">setSelection</a>()来选择文本。<a href="#setSelectionAttributes">setSelectionAttributes</a>()函数用来指出被选择文本应该如何被显示。使用<a href="#hasSelectedText">hasSelectedText</a>()来搜索是否有任何文本被选择。当前被选择文本的位置可以由<a href="#getSelection">getSelection</a>()提供并且被选择文本本身被<a href="#selectedText">selectedText</a>()返回。选择可以使用<a href="#copy">copy</a>()来复制到剪贴板，或者使用<a href="#cut">cut</a>()剪切到剪贴板中。它可以被<a href="#removeSelectedText">removeSelectedText</a>()删除。使用<a href="#selectAll">selectAll</a>()可以选择（或者取消选择）整个文本。QTextEdit支持多重选择。绝大多数选择函数是在默认选择（选择区0）中操作。如果用户按下非选择键，例如没有按下Shift的情况下的一个光标键，所有选择都被清空。
<p> 使用<a href="#setCursorPosition">setCursorPosition</a>()和<a href="#getCursorPosition">getCursorPosition</a>()可以分别设置和获得光标的位置。当光标被移动，信号<a href="#currentFontChanged">currentFontChanged</a>()、<a href="#currentColorChanged">currentColorChanged</a>()和<a href="#currentAlignmentChanged">currentAlignmentChanged</a>()被发射来影响新光标位置的字体、颜色和对齐方式。
<p> 如果文本改变了，<a href="#textChanged">textChanged</a>()信号被发射，并且如果用户通过按下回车键或者换行键插入一个新行，<a href="#returnPressed">returnPressed</a>()被发射。如果文本已经被修改，<a href="#isModified">isModified</a>()函数将会返回真。
<p> QTextEdit提供基于命令的撤销和恢复。使用<a href="#setUndoDepth">setUndoDepth</a>()可以设置命令历史的深度，默认为100步。调用<a href="#undo">undo</a>()或<a href="#redo">redo</a>()可以撤销或者恢复上一次操作。信号<a href="#undoAvailable">undoAvailable</a>()和<a href="#redoAvailable">redoAvailable</a>()表明撤销和恢复操作是否可以被执行。
<p> <a href="#indent">indent</a>()函数用来再次缩进一个段落。它对于代码编辑器是很有用的，例如，<em>Qt设计器</em>的代码编辑器中，<em>Ctrl+I</em>调用indent()函数。
<p> <h4> 编辑键绑定
</h4>
<a name="1-2-1"></a><p> 编辑中被实现的键绑定的列表：
<center><table cellpadding="4" cellspacing="2" border="0">
<tr bgcolor="#a2c511"> <th valign="top">按键 <th valign="top">操作
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Backspace</em> <td valign="top">删除光标左侧的字符
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Delete</em> <td valign="top">删除光标右侧的字符
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Ctrl+A</em> <td valign="top">移动光标到行首
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+B</em> <td valign="top">向左移动光标一个字符
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Ctrl+C</em> <td valign="top">复制标定的文本到剪贴板（也就是Windows下的<em>Ctrl+Insert</em>）
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+D</em> <td valign="top">删除光标右侧的字符
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Ctrl+E</em> <td valign="top">移动光标到行尾
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+F</em> <td valign="top">向右移动光标一个字符
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Ctrl+H</em> <td valign="top">删除光标左侧的字符
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+K</em> <td valign="top">删除到行尾
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Ctrl+N</em> <td valign="top">移动光标到下一行
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+P</em> <td valign="top">移动光标到上一行
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Ctrl+V</em> <td valign="top">把剪贴板文本粘贴到行编辑中（也就是Windows下的<em>Shift+Insert</em>）
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+X</em> <td valign="top">剪切标定的文本，复制到剪贴板（也就是Windows下的<em>Shift+Delete</em>）
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Ctrl+Z</em> <td valign="top">撤销最后一次操作
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+Y</em> <td valign="top">恢复最后一次操作
<tr bgcolor="#d0d0d0"> <td valign="top"><em>LeftArrow</em> <td valign="top">向左移动光标一个字符
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+LeftArrow</em> <td valign="top">向左移动光标一个单字
<tr bgcolor="#d0d0d0"> <td valign="top"><em>RightArrow</em> <td valign="top">向右移动光标一个字符
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+RightArrow</em> <td valign="top">向右移动光标一个单字
<tr bgcolor="#d0d0d0"> <td valign="top"><em>UpArrow</em> <td valign="top">移动光标到上一行
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+UpArrow</em> <td valign="top">移动光标到上一个单字
<tr bgcolor="#d0d0d0"> <td valign="top"><em>DownArrow</em> <td valign="top">移动光标到下一行
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+Down Arrow</em> <td valign="top">移动光标到下一个单字
<tr bgcolor="#d0d0d0"> <td valign="top"><em>PageUp</em> <td valign="top">移动光标到上一页
<tr bgcolor="#f0f0f0"> <td valign="top"><em>PageDown</em> <td valign="top">移动光标到下一页
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Home</em> <td valign="top">移动光标到行首
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+Home</em> <td valign="top">移动光标到文首
<tr bgcolor="#d0d0d0"> <td valign="top"><em>End</em> <td valign="top">移动光标到行尾
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+End</em> <td valign="top">移动光标到文尾
<tr bgcolor="#d0d0d0"> <td valign="top"><em>Shift+Wheel</em> <td valign="top">水平的滚动文本（Wheel就是鼠标滚轮）
<tr bgcolor="#f0f0f0"> <td valign="top"><em>Ctrl+Wheel</em> <td valign="top">缩放文本
</table></center>
<p> 要选择（标定）文本，按下一个移动键的同时按住Shift键，例如<i>Shift+右箭头</i>将会选择右面的字符，并且<i>Shift+Ctrl+右箭头</i>将会选择右面的单字，等等。
<p> 默认情况下，文本编辑窗口部件在插入模式下工作，所以用户输入的文本都被插入到文本编辑中并且光标右面的文本都会移动到不碍事的地方。使用<a href="#setOverwriteMode">setOverwriteMode</a>()，这个模式可以被改为覆盖，这时新文本将覆盖光标右面存在的任何文本。
<p> <p>也可以参考<a href="basic.html">基本窗口部件</a>和<a href="text.html">文本相关类</a>。

<hr><h2>成员类型文档</h2>
<h3 class=fn><a name="CursorAction-enum"></a>QTextEdit::CursorAction</h3> 
<p> 这个枚举变量被<a href="#moveCursor">moveCursor</a>()使用，它用来指定光标应该被移动的方向：
<ul>
<li><tt>QTextEdit::MoveBackward</tt> - 向后移动光标一个字符
<li><tt>QTextEdit::MoveWordBackward</tt> - 向后移动光标一个单字
<li><tt>QTextEdit::MoveForward</tt> - 向前移动光标一个字符
<li><tt>QTextEdit::MoveWordForward</tt> - 向前移动光标一个单字
<li><tt>QTextEdit::MoveUp</tt> - 向上移动光标一行
<li><tt>QTextEdit::MoveDown</tt> - 向下移动光标一行
<li><tt>QTextEdit::MoveLineStart</tt> - 移动光标到行首
<li><tt>QTextEdit::MoveLineEnd</tt> - 移动光标到行尾
<li><tt>QTextEdit::MoveHome</tt> - 移动光标到文首
<li><tt>QTextEdit::MoveEnd</tt> - 移动光标到文尾
<li><tt>QTextEdit::MovePgUp</tt> - 向上移动光标一页
<li><tt>QTextEdit::MovePgDown</tt> - 向下移动光标一页
</ul>

<h3 class=fn><a name="KeyboardAction-enum"></a>QTextEdit::KeyboardAction</h3> 
<p> 这个枚举变量被<a href="#doKeyboardAction">doKeyboardAction</a>()使用，它用来指定哪个操作被执行：
<ul>
<li><tt>QTextEdit::ActionBackspace</tt> - 删除光标左面的字符。
<li><tt>QTextEdit::ActionDelete</tt> - 删除光标右面的字符。
<li><tt>QTextEdit::ActionReturn</tt> - 在光标位置分割段落。
<li><tt>QTextEdit::ActionKill</tt> - 如果光标不在段尾，从光标位置删除字符，直到段尾。如果光标在段尾，删除段尾的硬回车符——这将会导致这个段落和随后的段落被连接在一起。
</ul>

<h3 class=fn><a name="VerticalAlignment-enum"></a>QTextEdit::VerticalAlignment</h3> 
<p> 这个枚举变量被用来设置文本的垂直对齐方式。
<ul>
<li><tt>QTextEdit::AlignNormal</tt> - 普通对齐
<li><tt>QTextEdit::AlignSuperScript</tt> - 上标
<li><tt>QTextEdit::AlignSubScript</tt> - 下标
</ul>

<h3 class=fn><a name="WordWrap-enum"></a>QTextEdit::WordWrap</h3> 
<p> 这个枚举变量定义了QTextEdit的自动换行模式。下面这些值是有效的：
<ul>
<li><tt>QTextEdit::NoWrap</tt> - 不自动换行。
<li><tt>QTextEdit::WidgetWidth</tt> - 在窗口部件的当前宽度自动换行（这是默认的）。默认在空白符号处自动换行，这可以使用<a href="#setWrapPolicy">setWrapPolicy</a>()来改变。
<li><tt>QTextEdit::FixedPixelWidth</tt> - 从窗口部件的左侧开始的固定数量的象素数自动换行。象素的数量可以通过<a href="#wrapColumnOrWidth">wrapColumnOrWidth</a>()来设置。
<li><tt>QTextEdit::FixedColumnWidth</tt> - 从窗口部件左侧开始的固定数量的列数自动换行。列数可以通过wrapColumnOrWidth()设置。如果你需要使用等宽文本在设备上显示很好的格式文本，这是很有用的，例如标准的VT100终端，你可以把wrapColumnOrWidth()设置为80。
</ul><p> <p>也可以参考<a href="#wordWrap-prop">wordWrap</a>和<a href="#wordWrap-prop">wordWrap</a>。

<h3 class=fn><a name="WrapPolicy-enum"></a>QTextEdit::WrapPolicy</h3> 
<p> 这个枚举变量定义了自动换行模式在哪里自动换行。
<p> 下面这些值是有效的：
<ul>
<li><tt>QTextEdit::AtWhiteSpace</tt> - 在空白符号处（空格或者换行）自动换行。
<li><tt>QTextEdit::Anywhere</tt> - 在任何情况下自动换行，包括单字中。
<li><tt>QTextEdit::AtWordBoundary</tt> - 不要使用这个不赞成的值（它是AtWhiteSpace的同义字，请使用后者替换它）。
</ul><p> <p>也可以参考<a href="#wrapPolicy-prop">wrapPolicy</a>。

<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QTextEdit"></a>QTextEdit::QTextEdit ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;text, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;context = QString::null, <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0 )
</h3>
使用父对象<em>parent</em>和名称<em>name</em>构造一个QTextEdit。文本编辑将使用上下文<em>context</em>来显示文本<em>text</em>。
<p> <em>context</em>是文本编辑的<a href="qmimesourcefactory.html">QMimeSourceFactory</a>用来解析文件和图片的定位的路径。当查询数据时，它被传递给<a href="#mimeSourceFactory">mimeSourceFactory</a>()。
<p> 例如，如果文本包含一个文本标签<tt>&lt;img src="image.png"&gt;</tt>，并且上下文为“path/to/look/in”，那么QMimeSourceFactory将会试图从“path/to/look/in/image.png”载入图片。如果标签为<tt>&lt;img src="/image.png"&gt;</tt>，context将不会被使用（因为QMimeSourceFactory识别出了我们使用的是绝对路径）并且将会试图载入“/image.png”。context也可以正确的适用于<em>hrefs</em>，例如<tt>&lt;a href="target.html"&gt;Target&lt;/a&gt;</tt>，将会被识别为“path/to/look/in/target.html”。

<h3 class=fn><a name="QTextEdit-2"></a>QTextEdit::QTextEdit ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0 )
</h3>  
使用父对象<em>parent</em>和名称<em>name</em>构造一个空的QTextEdit。

<h3 class=fn>int <a name="alignment"></a>QTextEdit::alignment () const
</h3>
返回当前段落的对齐方式。
<p> <p>也可以参考<a href="#setAlignment">setAlignment</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="anchorAt"></a>QTextEdit::anchorAt ( const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;pos )
</h3> 
如果在<em>pos</em>位置有一个锚（在内容坐标中），它的名称被返回，否则返回空字符串。