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.