QQuickTextDocument Class
QQuickTextDocument クラスは、QQuickTextEdit のQTextDocument へのアクセスを提供します。詳細...
| ヘッダー: | #include <QQuickTextDocument> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| QML内: | TextDocument |
| 継承元: | QObject |
プロパティ
(technology preview)errorString : QString(technology preview)modified : bool(technology preview)source : QUrl(technology preview)status : Status
パブリック関数
| QQuickTextDocument(QQuickItem *parent) | |
| QString | errorString() const |
| bool | isModified() const |
(technology preview) void | save() |
(technology preview) void | saveAs(const QUrl &url) |
| void | setModified(bool modified) |
| void | setSource(const QUrl &url) |
(since 6.7) void | setTextDocument(QTextDocument *document) |
| QUrl | source() const |
| QQuickTextDocument::Status | status() const |
| QTextDocument * | textDocument() const |
シグナル
(technology preview) void | errorStringChanged() |
(technology preview) void | modifiedChanged() |
(technology preview) void | sourceChanged() |
(technology preview) void | statusChanged() |
(since 6.7) void | textDocumentChanged() |
詳細な説明
このクラスは、QQuickTextEdit要素のQTextDocument へのアクセスを提供します。これは、ドキュメントの変更を含むQtのリッチテキスト処理機能を利用できるようにするために提供されています。また、QTextDocumentWriter などによるコンテンツの出力や、QSyntaxHighlighter などによる追加の書式設定にも使用できます。
プロパティのドキュメント
[read-only, technology preview] errorString : QString
この列挙型はテクノロジープレビュー段階にあり、変更される可能性があります。
このプロパティには、読み込みまたは保存中に発生したエラー（ある場合）を説明する、人間が読み取れる文字列が格納されます。
デフォルトでは、この文字列は空です。
この列挙型は Qt 6.7 で導入されました。
アクセス関数：
| QString | errorString() const |
Notifier シグナル:
| void | errorStringChanged() |
関連項目： status 、source 、save()、およびsaveAs()。
[technology preview] modified : bool
この列挙型はテクノロジープレビュー段階にあり、変更される可能性があります。
このプロパティは、ドキュメントがユーザーによって変更されたかどうかを保持します
このプロパティは、ドキュメントが前回読み込まれたか保存されて以来、ユーザーによって変更されたかどうかを示します。デフォルトでは、このプロパティは `false` です。
QTextDocument::modified と同様に、modified プロパティを設定できます。たとえば、false に設定すると、source プロパティを別の URL に設定できるようになります（これにより、ユーザーの変更内容は破棄されます）。
この列挙型は Qt 6.7 で導入されました。
アクセス関数:
| bool | isModified() const |
| void | setModified(bool modified) |
Notifierシグナル:
| void | modifiedChanged() |
「QTextDocument::modified」も参照してください 。
[technology preview] source : QUrl
この列挙型はテクノロジープレビュー段階にあり、変更される可能性があります。
このプロパティには、ドキュメントの内容を読み込むための URL が格納されます。
QQuickTextDocument は、Qtがサポートする任意のURLスキームから読み込まれた、Qtがサポートするあらゆるテキスト形式を処理できます。
ドキュメントのmodified 状態がtrue である間は、source プロパティを変更することはできません。ユーザーがドキュメントの内容を変更した場合は、save() を実行するか、modified をfalse に設定して変更を破棄するか、ユーザーに確認を求める必要があります。その後、source プロパティを別のURLに設定してください。
この列挙型は Qt 6.7 で導入されました。
アクセス関数：
| QUrl | source() const |
| void | setSource(const QUrl &url) |
Notifierシグナル:
| void | sourceChanged() |
関連項目: QTextDocumentWriter::supportedDocumentFormats()。
[read-only, technology preview] status : Status
この列挙型はテクノロジープレビュー段階にあり、変更される可能性があります。
このプロパティは、ドキュメントの読み込みまたは保存のステータスを保持します
このプロパティは、ドキュメントの読み込みまたは保存のステータスを保持します。以下のいずれかになります。
| 定数 | 説明 |
|---|---|
Null | ファイルは読み込まれていません |
Loading | source からの読み込みが開始されました |
Loaded | 読み込みが正常に完了しました |
Saving | save() またはsaveAs() の実行後、ファイルへの書き込みが開始されました |
Saved | 書き込みが正常に完了しました |
ReadError | xml-ph-0000@deepl.internal からの読み込み中にエラーが発生しましたsource |
WriteError | save() またはsaveAs() でエラーが発生しました |
NonLocalFileError | saveAs() が、ローカルファイルではなくリモートリソースを指す URL で呼び出されました |
この列挙型は Qt 6.7 で導入されました。
アクセス関数:
| QQuickTextDocument::Status | status() const |
Notifierシグナル:
| void | statusChanged() |
関連項目: errorString 、source 、save()、およびsaveAs()。
メンバ関数のドキュメント
QQuickTextDocument::QQuickTextDocument(QQuickItem *parent)
parent を親オブジェクトとして、QQuickTextDocumentオブジェクトを生成します。
[signal, technology preview] void QQuickTextDocument::errorStringChanged()
この機能はテクノロジープレビュー版であり、変更される可能性があります。
注： プロパティ `errorString` に対する通知 シグナル。
[signal, technology preview] void QQuickTextDocument::modifiedChanged()
この機能はテクノロジープレビュー版であり、変更される可能性があります。
注： プロパティ `modified` に対する通知 シグナル。
[invokable, technology preview] void QQuickTextDocument::save()
この機能はテクノロジープレビュー版であり、変更される可能性があります。
source で指定されたファイル名および形式で、内容を同じファイルに保存します。
注： ローカルファイルに保存するか、Android ではcontent の URL に保存することができます 。
注：この関数は 、メタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
この関数は Qt 6.7 で導入されました。
[invokable, technology preview] void QQuickTextDocument::saveAs(const QUrl &url)
この機能はテクノロジープレビュー版であり、変更される可能性があります。
url で指定されたファイルおよび形式に内容を保存します。
url で指定されたファイル拡張子は、ファイル形式を指定します（QMimeDatabase::mimeTypeForUrl() によって決定されます）。
注: ローカルファイルに保存するか、Android ではcontent の URL に保存することができます 。
注：この関数は 、メタオブジェクトシステムを介して、および QML から呼び出すことができます。Q_INVOKABLE を参照してください。
この関数は Qt 6.7 で導入されました。
[since 6.7] void QQuickTextDocument::setTextDocument(QTextDocument *document)
指定されたdocument を設定します。
ドキュメントの所有権は呼び出し元に留保されます。
この関数は Qt 6.7 で導入されました。
textDocument()も参照してください 。
[signal, technology preview] void QQuickTextDocument::sourceChanged()
この機能はテクノロジープレビュー版であり、変更される可能性があります。
注： プロパティ `source` に対する通知 シグナルです。
[signal, technology preview] void QQuickTextDocument::statusChanged()
この機能はテクノロジープレビュー版であり、変更される可能性があります。
注： プロパティ `status` に対する通知 シグナル。
QTextDocument *QQuickTextDocument::textDocument() const
QTextDocument オブジェクトへのポインタを返します。
「setTextDocument()」も参照してください 。
[signal, since 6.7] void QQuickTextDocument::textDocumentChanged()
このシグナルは、基となるQTextDocument が別のインスタンスに置き換えられた際に発火します。
この関数は Qt 6.7 で導入されました。
setTextDocument()も参照してください 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
