TextDocument QML Type (Uncreatable)

TextEdit のバックエンドであるQTextDocument をラップしたものです。詳細...

この型はテクノロジープレビュー版であり、変更される可能性があります。

注：これは作成不可能な型です。QML ではインスタンス化できません。

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• errorString : string (technology preview)
• modified : bool (technology preview)
• source : url (technology preview)
• status : enumeration (technology preview)

方法

• void save() (technology preview)
• void saveAs(url url) (technology preview)

詳細な説明

ドキュメントにテキストを読み込むには、source プロパティを設定します。その後、ユーザーがテキストを変更し、同じドキュメントを保存したい場合は、save()を呼び出して、同じソースに再度保存します（it's a local file の場合のみ）。または、saveAs()を呼び出して、別のファイルに保存します。

このクラスは QML 内でインスタンス化することはできませんが、TextEdit::textDocument から利用可能です。

プロパティのドキュメント

errorString : string [read-only, technology preview]

このプロパティはテクノロジープレビュー段階にあり、変更される可能性があります。

このプロパティには、読み込みまたは保存中に発生したエラー（ある場合）を説明する、人間が読み取れる文字列が格納されます。エラーが発生していない場合は、空の文字列になります。

このプロパティは Qt 6.7 で導入されました。

関連項目： status 、source 、save()、およびsaveAs()。

modified : bool [technology preview]

このプロパティはテクノロジープレビュー版であり、変更される可能性があります。

このプロパティは、ドキュメントが前回読み込まれたり保存されたりしてから、ユーザーによって変更されたかどうかを示します。デフォルトでは、このプロパティの値は `false` です。

QTextDocument::modified と同様に、modifiedプロパティを設定することができます。例えば、false に設定することで、source プロパティを別のURLに設定できるようになります（これにより、ユーザーの変更内容は破棄されます）。

このプロパティは Qt 6.7 で導入されました。

「QTextDocument::modified」も参照してください 。

source : url [technology preview]

この機能はテクノロジープレビュー版であり、変更される可能性があります。

QQuickTextDocument Qtがサポートするあらゆるテキスト形式に対応しており、QtがサポートするあらゆるURLスキームから読み込むことができます。

URL は絶対 URL でも、コンポーネントの URL に対する相対 URL でもかまいません。

ドキュメントのmodified 状態がtrue である間、source プロパティを変更することはできません。ユーザーがドキュメントの内容を変更した場合は、save()を実行するか、modified = false を設定して変更を破棄するか、ユーザーに確認を求める必要があります。その後、sourceプロパティを別のURLに設定してください。

このプロパティは Qt 6.7 で導入されました。

QTextDocumentWriter::supportedDocumentFormats()も参照してください 。

status : enumeration [read-only, technology preview]

このプロパティはテクノロジープレビュー段階にあり、変更される可能性があります。

このプロパティは、ドキュメントの読み込みまたは保存の状態を表します。以下のいずれかの値をとります：

このステータスを使用して、更新情報を提供したり、ステータスの変更に対して何らかの対応を行ったりしてください。たとえば、次のような処理が可能です:

• 状態の変更をトリガーする:

  State {
      name: 'loaded'
      when: textEdit.textDocument.status == textEdit.textDocument.Loaded
  }

• onStatusChanged シグナルハンドラを実装する：

  TextEdit {
      onStatusChanged: {
          if (textDocument.status === textDocument.Loaded)
              console.log('Loaded')
      }
  }

• ステータス値にバインドする：

  TextEdit {
      id: edit
      width: 300
      height: 200
      textFormat: TextEdit.MarkdownText
      textDocument.source: "example.md"
      wrapMode: TextEdit.WordWrap
  
      Text {
          anchors {
              bottom: parent.bottom
              right: parent.right
          }
          color: edit.textDocument.status === TextDocument.Loaded ? "darkolivegreen" : "tomato"
          text:
              switch (edit.textDocument.status) {
              case TextDocument.Loading:
                  return qsTr("Loading ") + edit.textDocument.source
              case TextDocument.Loaded:
                  return qsTr("Loaded ") + edit.textDocument.source
              default:
                  return edit.textDocument.errorString
              }
      }
  }

このプロパティは Qt 6.7 で導入されました。

errorString 、source 、save()、およびsaveAs()も参照してください 。

メソッドのドキュメント

[technology preview] void save()

このメソッドはテクノロジープレビュー版であり、変更される可能性があります。

source で指定されたのと同じファイルおよび形式で内容を保存します。

このメソッドは Qt 6.7 で導入されました。

source およびsaveAs()も参照してください 。

[technology preview] void saveAs(url url)

このメソッドはテクノロジープレビュー版であり、変更される可能性があります。

url で指定されたファイルおよび形式に内容を保存します。

url で指定されたファイル拡張子は、ファイル形式を指定します（QMimeDatabase::mimeTypeForUrl() によって決定されます）。

このメソッドは Qt 6.7 で導入されました。

source およびsave()も参照してください 。