TextDocument QML Type

Une enveloppe autour de TextEdit's backing QTextDocument. Plus...

Ce type est en cours de développement et peut être modifié.

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Méthodes

• void save() (preliminary)
• void saveAs(url url) (preliminary)

Description détaillée

Pour charger un texte dans le document, il faut définir la propriété source. Si l'utilisateur modifie ensuite le texte et souhaite enregistrer le même document, il doit appeler save() pour l'enregistrer à nouveau dans la même source (uniquement si it's a local file). Ou appelez saveAs() pour l'enregistrer dans un fichier différent.

Cette classe ne peut pas être instanciée dans QML, mais elle est disponible à partir de TextEdit::textDocument.

Documentation sur les propriétés

errorString : string [read-only, preliminary]

Cette propriété est en cours de développement et peut être modifiée.

Cette propriété contient une chaîne lisible par l'homme décrivant l'erreur qui s'est produite lors du chargement ou de l'enregistrement, le cas échéant ; sinon, une chaîne vide.

Cette propriété a été introduite dans Qt 6.7.

Voir aussi status, source, save(), et saveAs().

modified : bool [preliminary]

Cette propriété est en cours de développement et peut être modifiée.

Cette propriété indique si le document a été modifié par l'utilisateur depuis son dernier chargement ou enregistrement. Par défaut, cette propriété est false.

Comme pour QTextDocument::modified, vous pouvez définir la propriété modified : par exemple, définissez-la à false pour permettre de définir la propriété source à une URL différente (en supprimant ainsi les modifications apportées par l'utilisateur).

Cette propriété a été introduite dans Qt 6.7.

Voir aussi QTextDocument::modified.

source : url [preliminary]

Cette propriété est en cours de développement et peut être modifiée.

QQuickTextDocument peut gérer n'importe quel format de texte pris en charge par Qt, chargé à partir de n'importe quel schéma d'URL pris en charge par Qt.

L'URL peut être absolue ou relative à l'URL du composant.

La propriété source ne peut pas être modifiée tant que l'état du document modified est true. Si l'utilisateur a modifié le contenu du document, vous devez l'inviter à save() ou à annuler les modifications en définissant modified = false avant de définir la propriété source à une URL différente.

Cette propriété a été introduite dans Qt 6.7.

Voir aussi QTextDocumentWriter::supportedDocumentFormats().

status : enumeration [read-only, preliminary]

Cette propriété est en cours de développement et peut être modifiée.

Cette propriété indique l'état du chargement ou de l'enregistrement du document. Il peut s'agir de l'un des éléments suivants

Utilisez ce statut pour fournir une mise à jour ou répondre au changement de statut d'une manière ou d'une autre. Par exemple, vous pouvez

• Déclencher un changement d'état :

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

• implémenter un gestionnaire de signal onStatusChanged:

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

• se lier à la valeur de l'état :

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

Cette propriété a été introduite dans Qt 6.7.

Voir aussi errorString, source, save(), et saveAs().

Documentation de la méthode

[preliminary] void save()

Cette méthode est en cours de développement et peut être modifiée.

Enregistre le contenu dans le même fichier et le même format que ceux spécifiés par source.

Cette méthode a été introduite dans Qt 6.7.

Voir aussi source et saveAs().

[preliminary] void saveAs(url url)

Cette méthode est en cours de développement et peut être modifiée.

Enregistre le contenu dans le fichier et le format spécifiés par url.

L'extension du fichier dans url spécifie le format du fichier (tel que déterminé par QMimeDatabase::mimeTypeForUrl()).

Cette méthode a été introduite dans Qt 6.7.

Voir aussi source et save().