TextDocument QML Type (Uncreatable)

Une couche d'abstraction autour de l'QTextDocument sous-jacente de TextEdit. En savoir plus...

Ce type est en préversion technologique et est susceptible d'être modifié.

Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié en QML.

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

Propriétés

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

Méthodes

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

Description détaillée

Pour charger du texte dans le document, définissez la propriété source. Si l'utilisateur modifie ensuite le texte et souhaite enregistrer le même document, appelez save() pour l'enregistrer à nouveau dans la même source (uniquement si it's a local file). Vous pouvez également appeler saveAs() pour l'enregistrer dans un autre fichier.

Cette classe ne peut pas être instanciée en QML, mais est disponible via ` TextEdit::textDocument`.

Documentation des propriétés

errorString : string [read-only, technology preview]

Cette propriété est en phase de préversion technique et est susceptible d'être modifiée.

Cette propriété contient une chaîne de caractères lisible par l'utilisateur décrivant l'erreur survenue lors du chargement ou de l'enregistrement, le cas échéant ; sinon, elle contient une chaîne vide.

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

Voir également status, source, save() et saveAs().

modified : bool [technology preview]

Cette propriété est en phase de prévisualisation technique et est susceptible d'ê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é prend la valeur false.

Comme pour la propriété « QTextDocument::modified », vous pouvez définir la propriété « modified » : par exemple, définissez-la sur « false » pour permettre de définir la propriété « source » sur une URL différente (ce qui efface les modifications apportées par l'utilisateur).

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

Voir également QTextDocument::modified.

source : url [technology preview]

Cette fonctionnalité est en phase de préversion technique et est susceptible d'être modifiée.

QQuickTextDocument Peut prendre en charge 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 d’ modified du document est ` true`. Si l’utilisateur a modifié le contenu du document, vous devez lui demander s’il souhaite ` save()` ou bien ignorer les modifications en définissant ` modified = false ` avant de définir la propriété `source` sur une autre URL.

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

Voir également QTextDocumentWriter::supportedDocumentFormats().

status : enumeration [read-only, technology preview]

Cette propriété est en phase de préversion technique et est susceptible d'être modifiée.

Cette propriété indique l'état de chargement ou d'enregistrement du document. Elle peut prendre l'une des valeurs suivantes :

Utilisez cet état pour fournir une mise à jour ou réagir d’une manière ou d’une autre au changement d’état. Par exemple, vous pourriez :

• 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')
      }
  }

• Lier la valeur du statut :

  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 également errorString, source, save() et saveAs().

Documentation de la méthode

[technology preview] void save()

Cette méthode est en phase de préversion technique et est susceptible d'être modifiée.

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

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

Voir également ` source ` et ` saveAs()`.

[technology preview] void saveAs(url url)

Cette méthode est en phase de préversion technologique et est susceptible d'évoluer.

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

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

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

Voir également source et save().