QTextBlock Class Reference

[QtGui module]

该QTextBlock类提供一个容器，用于文本片段中QTextDocument。More…

Types

  • class **[iterator]($docs-index.htm)**

Methods

  • __init__ (self)
  • __init__ (self, QTextBlock o)
  • iterator begin (self)
  • QTextBlockFormat blockFormat (self)
  • int blockFormatIndex (self)
  • int blockNumber (self)
  • QTextCharFormat charFormat (self)
  • int charFormatIndex (self)
  • clearLayout (self)
  • bool contains (self, int position)
  • QTextDocument document (self)
  • iterator end (self)
  • int firstLineNumber (self)
  • bool isValid (self)
  • bool isVisible (self)
  • QTextLayout layout (self)
  • int length (self)
  • int lineCount (self)
  • QTextBlock next (self)
  • int position (self)
  • QTextBlock previous (self)
  • int revision (self)
  • setLineCount (self, int count)
  • setRevision (self, int rev)
  • setUserData (self, QTextBlockUserData data)
  • setUserState (self, int state)
  • setVisible (self, bool visible)
  • QString text (self)
  • Qt.LayoutDirection textDirection (self)
  • QTextList textList (self)
  • QTextBlockUserData userData (self)
  • int userState (self)

Special Methods

  • bool __eq__ (self, QTextBlock o)
  • bool __ge__ (self, QTextBlock o)
  • bool __lt__ (self, QTextBlock o)
  • bool __ne__ (self, QTextBlock o)

Detailed Description

该QTextBlock类提供一个容器，用于文本片段中QTextDocument。

文字块封装在一个块或一段文字QTextDocument。 QTextBlock提供QTextDocuments块/段落结构进行只读访问。主要的是使用，如果你想实现自己的布局的可视化表示形式QTextDocument，或者如果您想遍历一个文件，写出来的内容在自己的自定义格式。

文本块通过它们的父文件创建的。如果你需要创建一个新的文本块，或修改文件的内容，同时检查其内容，使用所提供的基于指针的接口QTextCursor代替。

每个文本块位于一个特定的position在（）document（ ） 。该块的内容可以通过使用所获得的text（）函数。该length（ ）函数确定文件（包括格式化字符）中的块的大小。块的可视属性是由它的文本确定layout（） ，其charFormat（） ，和其blockFormat（ ） 。

该next（）和previous（ ）函数使迭代连续有效块一份文件，该文件是由其他途径在迭代过程中不被修改的情况下。需要注意的是，虽然块序列中返回，相邻块可能来自于文件结构不同的地方。块的有效性可以通过调用确定isValid（ ） 。

QTextBlock提供了比较操作符，使其更容易与块工作：operator==（ ）比较两个块是否相等，operator!=（ ）比较两个街区的不平等，operator<（ ）确定数据块是否先于在同一文档中的另一个。

QTextBlock Class Reference - 图1

Method Documentation

  1. QTextBlock.__init__ (self)

副本other文本块的属性到这个文本块。

  1. QTextBlock.__init__ (self, QTextBlock o)
  1. iterator QTextBlock.begin (self)

[

返回一个文本块迭代器，指向文本块的开始。

]($docs-index.htm)

See also end（ ） 。

  1. QTextBlockFormat QTextBlock.blockFormat (self)

返回QTextBlockFormat描述块特定的属性。

See also charFormat（ ） 。

  1. int QTextBlock.blockFormatIndex (self)

返回一个索引到文档内部的块格式的文本块的格式列表。

See also QTextDocument.allFormats（ ） 。

  1. int QTextBlock.blockNumber (self)

返回此块的数量，或-1，如果块是无效的。

此功能被引入Qt的4.4 。

See also QTextCursor.blockNumber（ ） 。

  1. QTextCharFormat QTextBlock.charFormat (self)

返回QTextCharFormat描述块的字符格式。插入文本到一个空的块时，块的字符格式。

See also blockFormat（ ） 。

  1. int QTextBlock.charFormatIndex (self)

返回一个索引到文档内部的字符格式的文本块的字符格式列表。

See also QTextDocument.allFormats（ ） 。

  1. QTextBlock.clearLayout (self)

清除QTextLayout用来布局和显示模块的内容。

此功能被引入Qt的4.4 。

See also layout（ ） 。

  1. bool QTextBlock.contains (self, int position)

返回True如果给定的position位于文本块中，否则返回False 。

  1. QTextDocument QTextBlock.document (self)

[

返回该文本块属于文本文件，或者0，如果该文本块不属于任何文件。

]($docs-qtextdocument.html)

  1. iterator QTextBlock.end (self)

[

返回一个文本块迭代器，指向文本块的结尾。

]($docs-index.htm)

See also begin（ ）next（）和previous（ ） 。

  1. int QTextBlock.firstLineNumber (self)

返回该块的第一行号，或-1，如果该块是无效的。除非布局支持它，行号是相同的块数。

此功能被引入Qt的4.5 。

See also QTextBlock.blockNumber（ ） 。

  1. bool QTextBlock.isValid (self)

返回True如果该文本块是有效的，否则返回False 。

  1. bool QTextBlock.isVisible (self)

返回True如果该块是可见的，否则返回False 。

此功能被引入Qt的4.4 。

See also setVisible（ ） 。

  1. QTextLayout QTextBlock.layout (self)

返回QTextLayout用来布局和显示模块的内容。

注意，返回QTextLayout对象只能从documentChanged实现的一种变型QAbstractTextDocumentLayout子类。从外部原因未定义的行为施加的任何更改。

See also clearLayout（ ） 。

  1. int QTextBlock.length (self)

返回字符的块的长度。

Note:返回的长度包括所有格式的字符，例如，换行符。

See also text（ ）charFormat（）和blockFormat（ ） 。

  1. int QTextBlock.lineCount (self)

返回的行数。不是所有的文件布局支持此功能。

此功能被引入Qt的4.5 。

See also setLineCount（ ） 。

  1. QTextBlock QTextBlock.next (self)

[

返回文档中的文本块这个块后，或者一个空的文本块，如果这是最后一个。

注意，下一个块可以是在不同的帧或表本块。

]($docs-qtextblock.html)

See also previous（ ）begin（）和end（ ） 。

  1. int QTextBlock.position (self)

返回的文档内的块的第一个字符的索引。

  1. QTextBlock QTextBlock.previous (self)

[

返回文档中的文本块这个块之前，或者一个空的文本块，如果这是第一个。

注意，下一个块可以是在不同的帧或表本块。

]($docs-qtextblock.html)

See also next（ ）begin（）和end（ ） 。

  1. int QTextBlock.revision (self)

返回的块版本。

此功能被引入Qt的4.4 。

See also setRevision（）和QTextDocument.revision（ ） 。

  1. QTextBlock.setLineCount (self, int count)

设置行计数count。

此功能被引入Qt的4.5 。

See also lineCount（ ） 。

  1. QTextBlock.setRevision (self, int rev)

设置一个块修订rev。

此功能被引入Qt的4.4 。

See also revision（）和QTextDocument.revision（ ） 。

  1. QTextBlock.setUserData (self, QTextBlockUserData data)

重视给定的data反对的文本块。

QTextBlockUserData可以用来存储自定义设置。所有权被传递到下面的文本文件，即提供QTextBlockUserData如果相应的文本块被删除的对象将被删除。用户数据对象未存储在还原历史，所以撤消删除的文本块后，将无法使用。

例如，如果你写了一个程序编辑器中的IDE ，你可能想让你的用户设置断点视觉代码中的一个集成的调试器。在程序编辑器的文本行通常对应于一个QTextBlock。该QTextBlockUserData接口允许开发者存储数据的每个QTextBlock一样，例如在其中的源代码行的用户有一个断点集。当然，这也可以被存储在外部，但是通过将其存储在内部QTextDocument，将例如自动当用户删除与其相关的行删除。这真的只是一种方法，在存储自定义信息QTextDocument在不使用自定义属性QTextFormat这会影响撤销/重做堆栈。

这个函数是Qt 4.1中引入。

See also userData（ ） 。

  1. QTextBlock.setUserState (self, int state)

在指定的商店state在文本块的整数值。这可能是有用的，例如在一个语法高亮显示来存储文本解析状态。

这个函数是Qt 4.1中引入。

See also userState（ ） 。

  1. QTextBlock.setVisible (self, bool visible)

设置块的可见性visible。

此功能被引入Qt的4.4 。

See also isVisible（ ） 。

  1. QString QTextBlock.text (self)

返回块的内容为纯文本。

See also length（ ）charFormat（）和blockFormat（ ） 。

  1. Qt.LayoutDirection QTextBlock.textDirection (self)

[

返回解析文字方向。

]($docs-qt.html#LayoutDirection-enum)

如果块没有明确的方向设置，它会从块内容解决的方向。要么返回Qt.LeftToRight or Qt.RightToLeft。

此功能被引入Qt的4.7 。

See also QTextFormat.layoutDirection（ ）QString.isRightToLeft（）和Qt.LayoutDirection。

  1. QTextList QTextBlock.textList (self)

[

如果块代表一个列表项，则返回该项目所属的列表，否则返回0 。

](qtextlist.html)

  1. QTextBlockUserData QTextBlock.userData (self)

返回一个指针，指向一个QTextBlockUserData如果以前设置与对象setUserData（ ）或一个空指针。

这个函数是Qt 4.1中引入。

See also setUserData（ ） 。

  1. int QTextBlock.userState (self)

返回以前设置的整数值setUserState（）或-1。

这个函数是Qt 4.1中引入。

See also setUserState（ ） 。

  1. bool QTextBlock.__eq__ (self, QTextBlock o)
  1. bool QTextBlock.__ge__ (self, QTextBlock o)
  1. bool QTextBlock.__lt__ (self, QTextBlock o)
  1. bool QTextBlock.__ne__ (self, QTextBlock o)