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 |
プロパティ
(preliminary)errorString : const QString(preliminary)modified : bool(preliminary)source : QUrl(preliminary)status : const Status
パブリック機能
| QQuickTextDocument(QQuickItem *parent) | |
| QString | errorString() const |
| bool | isModified() const |
(preliminary) void | save() |
(preliminary) 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 |
シグナル
(preliminary) void | errorStringChanged() |
(preliminary) void | modifiedChanged() |
(preliminary) void | sourceChanged() |
(preliminary) void | statusChanged() |
(since 6.7) void | textDocumentChanged() |
詳細説明
このクラスは QQuickTextEdit 要素のQTextDocument へのアクセスを提供します。これは、ドキュメントの修正など、Qt のリッチテキスト処理機能を使用できるようにするために提供されます。また、QTextDocumentWriter などでコンテンツを出力したり、QSyntaxHighlighter などで追加のフォーマットを提供するために使用することもできます。
プロパティ ドキュメント
[read-only, preliminary] errorString : const QString
このプロパティは開発中であり、変更される可能性がある。
このプロパティは、ロード中または保存中に発生したエラーを説明する、人間が読める文字列を保持します。
デフォルトでは、この文字列は空です。
このプロパティは Qt 6.7 で導入されました。
アクセス関数です：
| QString | errorString() const |
Notifierシグナル：
| void | errorStringChanged() |
status,source,save(),saveAs()も参照してください 。
[preliminary] modified : bool
このプロパティは開発中であり、変更される可能性があります。
このプロパティは、ドキュメントがユーザによって変更されたかどうかを保持する。
このプロパティは、ドキュメントが最後にロードまたは保存されたときから、ユーザーによって変更されたかどうかを保持します。デフォルトでは、このプロパティはfalse です。
QTextDocument::modified と同様に、modified プロパティを設定することができます。例えば、false に設定すると、source プロパティを別の URL に設定することができます（したがって、ユーザーの変更は破棄されます）。
このプロパティは Qt 6.7 で導入されました。
アクセス関数
| bool | isModified() const |
| void | setModified(bool modified) |
Notifier シグナル：
| void | modifiedChanged() |
QTextDocument::modifiedも参照してください 。
[preliminary] source : QUrl
このプロパティは開発中であり、変更される可能性があります。
このプロパティは、ドキュメントのコンテンツをロードする URL を保持します。
QQuickTextDocument このプロパティは、Qt がサポートするあらゆる URL スキームからロードされる、Qt がサポートするあらゆるテキスト形式を扱うことができます。
source プロパティは、ドキュメントのmodified の状態がtrue である間は変更できません。ユーザがドキュメントの内容を変更した場合は、save() をユーザに促すか、modified をfalse に設定して変更を破棄してから、source プロパティを別の URL に設定する必要があります。
このプロパティは Qt 6.7 で導入されました。
アクセス関数です：
| QUrl | source() const |
| void | setSource(const QUrl &url) |
Notifier シグナル：
| void | sourceChanged() |
QTextDocumentWriter::supportedDocumentFormats()も参照してください 。
[read-only, preliminary] status : const Status
このプロパティは開発中であり、変更される可能性があります。
このプロパティは、文書の読み込みまたは保存の状態を保持する。
このプロパティは、文書の読み込みまたは保存の状態を保持する。以下のいずれかになります：
| 定数 | 説明 |
|---|---|
Null | ファイルが読み込まれていない |
Loading | source からの読み込みが開始された |
Loaded | 読み込みが正常に終了した |
Saving | save() またはsaveAs() の後にファイルの書き込みが開始された。 |
Saved | 書き込みが正常に終了しました |
ReadError | からの読み込み中にエラーが発生しました。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, preliminary] void QQuickTextDocument::errorStringChanged()
この機能は開発中のため、変更される場合があります。
注： errorString プロパティの通知シグナル。
[signal, preliminary] void QQuickTextDocument::modifiedChanged()
この機能は開発中のため、変更される場合があります。
注： modified プロパティの通知シグナル。
[invokable, preliminary] void QQuickTextDocument::save()
この機能は開発中のため、変更される可能性があります。
source で指定されたファイルおよびフォーマットと同じものに内容を保存する。
注意： 保存先はfile on a mounted filesystem のみです。
注意 ：この関数はメタオブジェクトシステム経由でも QML からでも呼び出すことができます。Q_INVOKABLE を参照してください。
この関数は Qt 6.7 で導入されました。
[invokable, preliminary] void QQuickTextDocument::saveAs(const QUrl &url)
この機能は開発中のため、変更される可能性があります。
url で指定されたファイルとフォーマットにコンテンツを保存する。
url のファイル拡張子は、ファイル形式を指定します（QMimeDatabase::mimeTypeForUrl() によって決定されます）。
注： file on a mounted filesystem にのみ保存できる。
注： この関数はメタオブジェクトシステム経由でも QML からでも呼び出すことができます。Q_INVOKABLE を参照してください。
この関数は Qt 6.7 で導入されました。
[since 6.7] void QQuickTextDocument::setTextDocument(QTextDocument *document)
与えられたdocument を設定する。
呼び出し元はドキュメントの所有権を保持します。
この関数は Qt 6.7 で導入されました。
textDocument()も参照してください 。
[signal, preliminary] void QQuickTextDocument::sourceChanged()
この機能は開発中のため、変更される場合があります。
注： source プロパティの通知シグナル。
[signal, preliminary] void QQuickTextDocument::statusChanged()
この機能は開発中のため、変更される場合があります。
注： status プロパティの通知シグナル。
QTextDocument *QQuickTextDocument::textDocument() const
QTextDocument オブジェクトへのポインタを返す。
setTextDocument()も参照 。
[signal, since 6.7] void QQuickTextDocument::textDocumentChanged()
このシグナルは、QTextDocument が別のインスタンスに置き換わったときに発行されます。
この関数は Qt 6.7 で導入されました。
setTextDocument()も参照してください 。
© 2025 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.
