QTextBlockGroup¶
Inherited by: QTextList
Synopsis¶
Virtual functions¶
- def blockFormatChanged (block)
- def blockInserted (block)
- def blockRemoved (block)
Detailed Description¶
The PySide.QtGui.QTextBlockGroup class provides a container for text blocks within a PySide.QtGui.QTextDocument .
Block groups can be used to organize blocks of text within a document. They maintain an up-to-date list of the text blocks that belong to them, even when text blocks are being edited.
Each group has a parent document which is specified when the group is constructed.
Text blocks can be inserted into a group with PySide.QtGui.QTextBlockGroup.blockInserted() , and removed with PySide.QtGui.QTextBlockGroup.blockRemoved() . If a block’s format is changed, PySide.QtGui.QTextBlockGroup.blockFormatChanged() is called.
The list of blocks in the group is returned by PySide.QtGui.QTextBlockGroup.blockList() . Note that the blocks in the list are not necessarily adjacent elements in the document; for example, the top-level items in a multi-level list will be separated by the items in lower levels of the list.
- class PySide.QtGui.QTextBlockGroup(doc)¶
Parameters: doc – PySide.QtGui.QTextDocument Creates a new new block group for the given document .
Warning
This function should only be called from QTextDocument.createObject() .
- PySide.QtGui.QTextBlockGroup.blockFormatChanged(block)¶
Parameters: block – PySide.QtGui.QTextBlock This function is called whenever the specified block of text is changed. The text block is a member of this group.
The base class implementation does nothing.
- PySide.QtGui.QTextBlockGroup.blockInserted(block)¶
Parameters: block – PySide.QtGui.QTextBlock Appends the given block to the end of the group.
Warning
If you reimplement this function you must call the base class implementation.
- PySide.QtGui.QTextBlockGroup.blockList()¶
Return type: Returns a (possibly empty) list of all the blocks that are part of the block group.
- PySide.QtGui.QTextBlockGroup.blockRemoved(block)¶
Parameters: block – PySide.QtGui.QTextBlock Removes the given block from the group; the block itself is not deleted, it simply isn’t a member of this group anymore.
