Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] QTextDocumentFragment Class Reference
^{[модуль QtGui ]}

The QTextDocumentFragment class represents a piece of formatted text from a QTextDocument. Далее...

 #include <QTextDocumentFragment>

• Список всех членов, включая унаследованные

[править] Открытые функции

• QTextDocumentFragment ()
• QTextDocumentFragment ( const QTextDocument * document )
• QTextDocumentFragment ( const QTextCursor & cursor )
• QTextDocumentFragment ( const QTextDocumentFragment & other )
• ~QTextDocumentFragment ()
• bool isEmpty () const
• QString toHtml ( const QByteArray & encoding ) const
• QString toHtml () 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() and 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 ()

Constructs an empty QTextDocumentFragment.

See also isEmpty().

[править]

QTextDocumentFragment::QTextDocumentFragment ( const QTextDocument * document )

Converts the given document into a QTextDocumentFragment. Note that the QTextDocumentFragment only stores the document contents, not meta information like the document's title.

[править]

QTextDocumentFragment::QTextDocumentFragment ( const QTextCursor & cursor )

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

See also isEmpty() and QTextCursor::selection().

[править]

QTextDocumentFragment::QTextDocumentFragment ( const QTextDocumentFragment & other )

Copy constructor. Creates a copy of the other fragment.

[править]

QTextDocumentFragment::~QTextDocumentFragment ()

Destroys the document fragment.

[править]

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

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

[править]

QTextDocumentFragment QTextDocumentFragment::fromHtml ( const QString & text, const QTextDocument * resourceProvider ) [static]

Эта перегруженная функция предоставлена для удобства.

Returns a QTextDocumentFragment based on the arbitrary piece of HTML in the given text. The formatting is preserved as much as possible; for example, "bold" 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 ( const QString & plainText ) [static]

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

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

[править]

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

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

Эта функция была введена в Qt 4.2.

See also toPlainText(), QTextDocument::toHtml(), and QTextCodec.

[править]

QString QTextDocumentFragment::toHtml () const

Эта перегруженная функция предоставлена для удобства.

[править]

QString QTextDocumentFragment::toPlainText () const

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

See also toHtml().

[править]

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

Assigns the other fragment to this fragment.