QTextDocumentFragment 類

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

頭: #include <QTextDocumentFragment>
qmake: QT += gui

注意: 此類的所有函數 可重入 .

公共函數

QTextDocumentFragment ()
QTextDocumentFragment (const QTextDocument * document )
QTextDocumentFragment (const QTextCursor & cursor )
QTextDocumentFragment (const QTextDocumentFragment & other )
~QTextDocumentFragment ()
bool isEmpty () const
QString toHtml (const QByteArray & encoding = QByteArray()) const
QString toPlainText () const
QTextDocumentFragment & operator= (const QTextDocumentFragment & other )

靜態公共成員

QTextDocumentFragment fromHtml (const QString & text )
QTextDocumentFragment fromHtml (const QString & text , const QTextDocument * resourceProvider )
QTextDocumentFragment fromPlainText (const QString & plainText )

詳細描述

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:: QTextDocumentFragment ()

構造空的 QTextDocumentFragment .

另請參閱 isEmpty ().

QTextDocumentFragment:: QTextDocumentFragment (const QTextDocument * document )

轉換給定 document QTextDocumentFragment 。注意, QTextDocumentFragment only stores the document contents, not meta information like the document's title.

QTextDocumentFragment:: QTextDocumentFragment (const QTextCursor & cursor )

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

另請參閱 isEmpty () 和 QTextCursor::selection ().

QTextDocumentFragment:: QTextDocumentFragment (const QTextDocumentFragment & other )

拷貝構造函數。創建副本針對 other 片段。

QTextDocumentFragment:: ~QTextDocumentFragment ()

銷毀文檔片段。

[static] QTextDocumentFragment QTextDocumentFragment:: fromHtml (const QString & text )

返迴 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.

[static] QTextDocumentFragment QTextDocumentFragment:: fromHtml (const QString & text , const 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 引入。

[static] QTextDocumentFragment QTextDocumentFragment:: fromPlainText (const 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 () const

返迴 true if the fragment is empty; otherwise returns false .

QString QTextDocumentFragment:: toHtml (const QByteArray & encoding = QByteArray()) const

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 (),和 QTextCodec .

QString QTextDocumentFragment:: toPlainText () const

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

另請參閱 toHtml ().

QTextDocumentFragment &QTextDocumentFragment:: operator= (const QTextDocumentFragment & other )

賦值 other fragment to this fragment.