TextDocument QML Type (Uncreatable)

Ein Wrapper um die zugrunde liegende „ QTextDocument “ von TextEdit. Mehr...

Dieser Typ befindet sich in der Technologievorschau und kann sich noch ändern.

Hinweis: Bei diesem Typ handelt es sich um einen nicht erstellbaren Typ. Er kann in QML nicht instanziiert werden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Methoden

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

Ausführliche Beschreibung

Um Text in das Dokument zu laden, setzen Sie die Eigenschaft „ source “. Wenn der Benutzer den Text anschließend ändert und dasselbe Dokument speichern möchte, rufen Sie „ save()“ auf, um es erneut unter demselben Namen zu speichern (nur wenn „ it's a local file “ ist). Oder rufen Sie „ saveAs()“ auf, um es in einer anderen Datei zu speichern.

Diese Klasse kann in QML nicht instanziiert werden, ist jedoch über ` TextEdit::textDocument` verfügbar.

Dokumentation zu den Eigenschaften

errorString : string [read-only, technology preview]

Diese Eigenschaft befindet sich in der Technologievorschau und kann sich noch ändern.

Diese Eigenschaft enthält eine für Menschen lesbare Zeichenfolge, die den beim Laden oder Speichern aufgetretenen Fehler beschreibt, falls vorhanden; andernfalls eine leere Zeichenfolge.

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

Siehe auch „ status“ , „ source “, „ save()“ und „ saveAs()“.

modified : bool [technology preview]

Diese Eigenschaft befindet sich in der Technologievorschau und kann sich ändern.

Diese Eigenschaft gibt an, ob das Dokument seit dem letzten Laden oder Speichern vom Benutzer geändert wurde. Standardmäßig lautet diese Eigenschaft „ false “.

Wie bei „ QTextDocument::modified “ können Sie die Eigenschaft „modified“ festlegen: Setzen Sie sie beispielsweise auf „ false “, um die Eigenschaft „ source “ auf eine andere URL zu setzen (wodurch die Änderungen des Benutzers verworfen werden).

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

Siehe auch QTextDocument::modified.

source : url [technology preview]

Diese Funktion befindet sich in der Technologievorschau und kann sich noch ändern.

QQuickTextDocument kann jedes von Qt unterstützte Textformat verarbeiten, das über jedes von Qt unterstützte URL-Schema geladen wird.

Die URL kann absolut oder relativ zur URL der Komponente sein.

Die Eigenschaft „ source “ kann nicht geändert werden, solange der Status „ modified “ des Dokuments auf „ true “ gesetzt ist. Wenn der Benutzer den Dokumentinhalt geändert hat, sollten Sie den Benutzer fragen, ob er die Änderungen speichern möchte („ save()“), oder andernfalls die Änderungen verwerfen, indem Sie „ modified = false “ setzen, bevor Sie die Eigenschaft „source“ auf eine andere URL setzen.

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

Siehe auch ` QTextDocumentWriter::supportedDocumentFormats()` ().

status : enumeration [read-only, technology preview]

Diese Eigenschaft befindet sich in der Technologievorschau und kann sich ändern.

Diese Eigenschaft gibt den Status beim Laden oder Speichern eines Dokuments an. Mögliche Werte sind:

Verwenden Sie diesen Status, um eine Aktualisierung bereitzustellen oder auf die Statusänderung in irgendeiner Weise zu reagieren. Sie könnten beispielsweise:

• Eine Statusänderung auslösen:

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

• Einen Signal-Handler für „ onStatusChanged “ implementieren:

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

• Eine Bindung an den Statuswert herstellen:

  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
              }
      }
  }

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

Siehe auch „ errorString“ , „ source “, „ save()“ und „ saveAs()“.

Methodendokumentation

[technology preview] void save()

Diese Methode befindet sich in der Technologievorschau und kann sich noch ändern.

Speichert den Inhalt in derselben Datei und imselben Format, wie durch „ source “ angegeben.

Diese Methode wurde in Qt 6.7 eingeführt.

Siehe auch ` source ` und ` saveAs()`.

[technology preview] void saveAs(url url)

Diese Methode befindet sich in der Technologievorschau und kann sich noch ändern.

Speichert den Inhalt in der Datei und im Format, die durch „ url “ angegeben sind.

Die Dateierweiterung in url gibt das Dateiformat an (wie durch QMimeDatabase::mimeTypeForUrl() festgelegt).

Diese Methode wurde in Qt 6.7 eingeführt.

Siehe auch source und save().