QTextDocumentFragment Class
QTextDocumentFragment クラスは、QTextDocument から整形されたテキストの一部を表します。 ...続きを読む
Header: | #include <QTextDocumentFragment> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake: | QT += gui |
- 継承したメンバを含む、すべてのメンバの一覧
- QTextDocumentFragment はRich Text Processing APIおよびImplicitly Shared Classes に含まれています。
注意:このクラスの関数はすべてリエントラントです。
パブリック関数
QTextDocumentFragment() | |
QTextDocumentFragment(const QTextCursor &cursor) | |
QTextDocumentFragment(const QTextDocument *document) | |
QTextDocumentFragment(const QTextDocumentFragment &other) | |
~QTextDocumentFragment() | |
bool | isEmpty() const |
QString | toHtml() const |
(since 6.4) QString | toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const |
QString | toPlainText() const |
(since 6.4) QString | toRawText() const |
QTextDocumentFragment & | operator=(const QTextDocumentFragment &other) |
静的パブリックメンバ
QTextDocumentFragment | fromHtml(const QString &text, const QTextDocument *resourceProvider = nullptr) |
(since 6.4) QTextDocumentFragment | fromMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) |
QTextDocumentFragment | fromPlainText(const QString &plainText) |
詳細説明
QTextDocumentFragment は、QTextDocument に挿入できるリッチテキストの断片です。文書断片は、QTextDocument から作成したり、QTextCursor の選択範囲から作成したり、別の文書断片から作成したりすることができます。文書フ ラ グ メ ン ト は、 静的関数fromPlainText () ・fromHtml () で作成す る こ と も で き ます。
文書断片の内容は、toRawText() 関数で生テキストとして、toPlainText() 関数で ASCII として、toHtml() 関数で HTML として、toMarkdown() 関数で Markdown として取得することができます。
メンバ関数 ドキュメント
QTextDocumentFragment::QTextDocumentFragment()
空の QTextDocumentFragment を構築します。
isEmpty()も参照してください 。
[explicit]
QTextDocumentFragment::QTextDocumentFragment(const QTextCursor &cursor)
cursor の選択範囲から QTextDocumentFragment を作成します。カーソルに選択範囲がない場合、作成されるフラグメントは空です。
isEmpty() およびQTextCursor::selection()も参照してください 。
[explicit]
QTextDocumentFragment::QTextDocumentFragment(const QTextDocument *document)
与えられたdocument を QTextDocumentFragment に変換します。QTextDocumentFragment はドキュメントの内容のみを格納し、ドキュメントのタイトルのようなメタ情報は格納しないことに注意してください。
QTextDocumentFragment::QTextDocumentFragment(const QTextDocumentFragment &other)
コピーコンストラクタ。other フラグメントのコピーを作成します。
[noexcept]
QTextDocumentFragment::~QTextDocumentFragment()
ドキュメントフラグメントを破棄します。
[static]
QTextDocumentFragment QTextDocumentFragment::fromHtml(const QString &text, const QTextDocument *resourceProvider = nullptr)
与えられたtext 内の HTML の任意の部分に基づいたQTextDocumentFragment を返します。書式は可能な限り保持されます。例えば、"<b>bold</b>" は、"bold" というテキストを太字の書式で持つドキュメントフラグメントになります。
提供されたHTMLが、インポートされたスタイルシートなどの外部リソースへの参照を含んでいる場合、それらはresourceProvider を通して読み込まれます。
[static, since 6.4]
QTextDocumentFragment QTextDocumentFragment::fromMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub)
指定されたmarkdown テキストをもとに、指定されたfeatures でQTextDocumentFragment を返します。デフォルトは GitHub 方言です。
書式は可能な限り保持されます。例えば、**bold**
は "bold" というテキストを太字の文字スタイルで含むドキュメントフラグメントになります。
注意: 外部リソースの読み込みはサポートされていません。
この関数は Qt 6.4 で導入されました。
[static]
QTextDocumentFragment QTextDocumentFragment::fromPlainText(const QString &plainText)
与えられたplainText を含む文書断片を返します。
こ の よ う な断片をQTextDocument に挿入す る 際には、 挿入に用い ら れたQTextCursor のカ レ ン ト 文字書式が、 テ キ ス ト の書式 と し て用い ら れます。
bool QTextDocumentFragment::isEmpty() const
フラグメントが空の場合はtrue
を返し、そうでない場合はfalse
を返します。
QString QTextDocumentFragment::toHtml() const
ドキュメント断片の内容を HTML として返します。
toPlainText()、toMarkdown() およびQTextDocument::toHtml()も参照 。
[since 6.4]
QString QTextDocumentFragment::toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const
ドキュメント片の内容を、指定したfeatures の Markdown 形式で返します。デフォルトは GitHub 方言です。
この関数は Qt 6.4 で導入されました。
toPlainText() およびQTextDocument::toMarkdown()も参照してください 。
QString QTextDocumentFragment::toPlainText() const
この関数はtoRawText() と同じものを返しますが、いくつかの unicode 文字を ASCII の代替文字に置き換えます。特に、改行なしのスペース (U+00A0) は通常のスペース (U+0020) に置き換えられ、段落 (U+2029) と行 (U+2028) の両方のセパレータは改行 (U+000A) に置き換えられます。文書の正確な内容が必要な場合は、代わりにtoRawText() を使う。
toHtml()、toMarkdown()、toRawText()も参照 。
[since 6.4]
QString QTextDocumentFragment::toRawText() const
ドキュメント・フラグメントのテキストを、生のテキスト(つまり、フォーマット情報を含まない)として返します。
この関数は Qt 6.4 で導入されました。
toHtml()、toMarkdown()、toPlainText()も参照してください 。
QTextDocumentFragment &QTextDocumentFragment::operator=(const QTextDocumentFragment &other)
このフラグメントにother フラグメントを割り当てます。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。