QTextDocumentFragment Class Reference

[ QtGui module]

The QTextDocumentFragment class represents a piece of formatted text from a QTextDocument . 更多...

方法

Static Methods


详细描述

The QTextDocumentFragment class represents a piece of formatted text from a QTextDocument .

A QTextDocumentFragment is a fragment of rich text, that can be inserted into a QTextDocument . A document fragment can be created from a QTextDocument , from a QTextCursor 's selection, or from another document fragment. Document fragments can also be created by the static functions, fromPlainText () 和 fromHtml ().

The contents of a document fragment can be obtained as plain text by using the toPlainText () function, or it can be obtained as HTML with toHtml ().


方法文档编制

QTextDocumentFragment.__init__ ( self )

构造空 QTextDocumentFragment .

另请参阅 isEmpty ().

QTextDocumentFragment.__init__ ( self , QTextDocument   document )

转换给定 document QTextDocumentFragment 。注意 the QTextDocumentFragment only stores the document contents, not meta information like the document's title.

QTextDocumentFragment.__init__ ( self , QTextCursor   range )

创建 QTextDocumentFragment cursor 's selection. If the cursor doesn't have a selection, the created fragment is empty.

另请参阅 isEmpty () 和 QTextCursor.selection ().

QTextDocumentFragment.__init__ ( self , QTextDocumentFragment   rhs )

拷贝构造函数。创建副本针对 other 片段。

QTextDocumentFragment QTextDocumentFragment.fromHtml (QString  html )

返回 QTextDocumentFragment based on the arbitrary piece of HTML in the given text . The formatting is preserved as much as possible; for example, "<b>bold</b>" will become a document fragment with the text "bold" with a bold character format.

QTextDocumentFragment QTextDocumentFragment.fromHtml (QString  html , QTextDocument   resourceProvider )

返回 QTextDocumentFragment based on the arbitrary piece of HTML in the given text . The formatting is preserved as much as possible; for example, "<b>bold</b>" will become a document fragment with the text "bold" with a bold character format.

If the provided HTML contains references to external resources such as imported style sheets, then they will be loaded through the resourceProvider .

该函数在 Qt 4.2 引入。

QTextDocumentFragment QTextDocumentFragment.fromPlainText (QString  plainText )

Returns a document fragment that contains the given plainText .

When inserting such a fragment into a QTextDocument the current char format of the QTextCursor used for insertion is used as format for the text.

bool QTextDocumentFragment.isEmpty ( self )

Returns true if the fragment is empty; otherwise returns false.

QString QTextDocumentFragment.toHtml ( self )

Returns the contents of the document fragment as HTML, using the specified encoding (e.g., "UTF-8", "ISO 8859-1").

该函数在 Qt 4.2 引入。

另请参阅 toPlainText (), QTextDocument.toHtml (), and QTextCodec .

QString QTextDocumentFragment.toHtml ( self , QByteArray   encoding )

这是重载函数。

QString QTextDocumentFragment.toPlainText ( self )

Returns the document fragment's text as plain text (i.e. with no formatting information).

另请参阅 toHtml ().