Sur cette page

QTextDocument Class

La classe `QTextDocument` contient du texte mis en forme. En savoir plus…

En-tête : #include <QTextDocument>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Hérite de : QObject

Remarque : toutes les fonctions de cette classe sont réentrantes.

Types publics

enum FindFlag { FindBackward, FindCaseSensitively, FindWholeWords }
flags FindFlags
enum MarkdownFeature { MarkdownNoHTML, MarkdownDialectCommonMark, MarkdownDialectGitHub }
flags MarkdownFeatures
enum MetaInformation { DocumentTitle, DocumentUrl, CssMedia, FrontMatter }
(since 6.1) ResourceProvider
enum ResourceType { UnknownResource, HtmlResource, ImageResource, StyleSheetResource, MarkdownResource, UserResource }
enum Stacks { UndoStack, RedoStack, UndoAndRedoStacks }

Propriétés

Fonctions publiques

QTextDocument(QObject *parent = nullptr)
QTextDocument(const QString &text, QObject *parent = nullptr)
virtual ~QTextDocument()
void addResource(int type, const QUrl &name, const QVariant &resource)
void adjustSize()
QList<QTextFormat> allFormats() const
int availableRedoSteps() const
int availableUndoSteps() const
QUrl baseUrl() const
(since 6.0) qreal baselineOffset() const
QTextBlock begin() const
int blockCount() const
QChar characterAt(int pos) const
int characterCount() const
virtual void clear()
void clearUndoRedoStacks(QTextDocument::Stacks stacksToClear = UndoAndRedoStacks)
QTextDocument *clone(QObject *parent = nullptr) const
Qt::CursorMoveStyle defaultCursorMoveStyle() const
QFont defaultFont() const
QString defaultStyleSheet() const
QTextOption defaultTextOption() const
QAbstractTextDocumentLayout *documentLayout() const
qreal documentMargin() const
void drawContents(QPainter *p, const QRectF &rect = QRectF())
QTextBlock end() const
QTextCursor find(const QRegularExpression &expr, const QTextCursor &cursor, QTextDocument::FindFlags options = FindFlags()) const
QTextCursor find(const QRegularExpression &expr, int from = 0, QTextDocument::FindFlags options = FindFlags()) const
QTextCursor find(const QString &subString, const QTextCursor &cursor, QTextDocument::FindFlags options = FindFlags()) const
QTextCursor find(const QString &subString, int position = 0, QTextDocument::FindFlags options = FindFlags()) const
QTextBlock findBlock(int pos) const
QTextBlock findBlockByLineNumber(int lineNumber) const
QTextBlock findBlockByNumber(int blockNumber) const
QTextBlock firstBlock() const
qreal idealWidth() const
qreal indentWidth() const
bool isEmpty() const
bool isLayoutEnabled() const
bool isModified() const
bool isRedoAvailable() const
bool isUndoAvailable() const
bool isUndoRedoEnabled() const
QTextBlock lastBlock() const
int lineCount() const
void markContentsDirty(int position, int length)
int maximumBlockCount() const
QString metaInformation(QTextDocument::MetaInformation info) const
QTextObject *object(int objectIndex) const
QTextObject *objectForFormat(const QTextFormat &f) const
int pageCount() const
QSizeF pageSize() const
void print(QPagedPaintDevice *printer) const
void redo(QTextCursor *cursor)
QVariant resource(int type, const QUrl &name) const
(since 6.1) QTextDocument::ResourceProvider resourceProvider() const
int revision() const
QTextFrame *rootFrame() const
void setBaseUrl(const QUrl &url)
(since 6.0) void setBaselineOffset(qreal baseline)
void setDefaultCursorMoveStyle(Qt::CursorMoveStyle style)
void setDefaultFont(const QFont &font)
void setDefaultStyleSheet(const QString &sheet)
void setDefaultTextOption(const QTextOption &option)
void setDocumentLayout(QAbstractTextDocumentLayout *layout)
void setDocumentMargin(qreal margin)
void setHtml(const QString &html)
void setIndentWidth(qreal width)
void setLayoutEnabled(bool b)
void setMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = MarkdownDialectGitHub)
void setMaximumBlockCount(int maximum)
void setMetaInformation(QTextDocument::MetaInformation info, const QString &string)
void setPageSize(const QSizeF &size)
void setPlainText(const QString &text)
(since 6.1) void setResourceProvider(const QTextDocument::ResourceProvider &provider)
(since 6.0) void setSubScriptBaseline(qreal baseline)
(since 6.0) void setSuperScriptBaseline(qreal baseline)
void setTextWidth(qreal width)
void setUndoRedoEnabled(bool enable)
void setUseDesignMetrics(bool b)
QSizeF size() const
(since 6.0) qreal subScriptBaseline() const
(since 6.0) qreal superScriptBaseline() const
qreal textWidth() const
QString toHtml() const
QString toMarkdown(QTextDocument::MarkdownFeatures features = MarkdownDialectGitHub) const
QString toPlainText() const
QString toRawText() const
void undo(QTextCursor *cursor)
bool useDesignMetrics() const

Emplacements publics

void redo()
void setModified(bool m = true)
void undo()

Signaux

void baseUrlChanged(const QUrl &url)
void blockCountChanged(int newBlockCount)
void contentsChange(int position, int charsRemoved, int charsAdded)
void contentsChanged()
void cursorPositionChanged(const QTextCursor &cursor)
void documentLayoutChanged()
void modificationChanged(bool changed)
void redoAvailable(bool available)
void undoAvailable(bool available)
void undoCommandAdded()

Membres publics statiques

(since 6.1) QTextDocument::ResourceProvider defaultResourceProvider()
(since 6.1) void setDefaultResourceProvider(const QTextDocument::ResourceProvider &provider)

Fonctions protégées

virtual QTextObject *createObject(const QTextFormat &format)
virtual QVariant loadResource(int type, const QUrl &name)

Description détaillée

QTextDocument est un conteneur destiné aux documents de texte enrichi structurés, prenant en charge le texte formaté et divers types d’éléments de document, tels que les listes, les tableaux, les cadres et les images. Ces documents peuvent être créés pour être utilisés dans un QTextEdit, ou utilisés de manière indépendante.

Chaque élément de document est décrit par un objet de format associé. Chaque objet de format est traité comme un objet unique par QTextDocuments et peut être transmis à la fonction ` objectForFormat()` pour obtenir l'élément de document auquel il s'applique.

Un QTextDocument peut être modifié par programmation à l’aide de la fonction ` QTextCursor`, et son contenu peut être examiné en parcourant la structure du document. L’ensemble de la structure du document est stocké sous la forme d’une hiérarchie d’éléments de document sous le cadre racine, accessible via la fonction ` rootFrame()`. Par ailleurs, si vous souhaitez simplement parcourir le contenu textuel du document, vous pouvez utiliser les fonctions ` begin()`, ` end()` et ` findBlock()` pour récupérer des blocs de texte que vous pourrez examiner et parcourir.

La mise en page d’un document est déterminée par la fonction ` documentLayout()` ; vous pouvez créer votre propre sous-classe de ` QAbstractTextDocumentLayout ` et la définir à l’aide de la fonction ` setDocumentLayout()` si vous souhaitez utiliser votre propre logique de mise en page. Le titre du document et d’autres métadonnées peuvent être obtenus en appelant la fonction metaInformation(). Pour les documents mis à la disposition des utilisateurs via la classe QTextEdit, le titre du document est également accessible via la fonction QTextEdit::documentTitle().

Les fonctions de commodité toPlainText() et toHtml() vous permettent de récupérer le contenu du document au format texte brut et HTML. Le texte du document peut faire l’objet d’une recherche à l’aide des fonctions find().

Les opérations d'annulation et de rétablissement effectuées sur le document peuvent être contrôlées à l'aide de la fonction ` setUndoRedoEnabled()`. Le système d'annulation et de rétablissement peut être contrôlé par un widget d'éditeur via les slots ` undo()` et ` redo()` ; le document fournit également les signaux ` contentsChanged()`, ` undoAvailable()` et ` redoAvailable()` qui informent les widgets d'éditeur connectés de l'état du système d'annulation et de rétablissement. Voici les opérations d'annulation et de rétablissement d'un QTextDocument :

  • Insertion ou suppression de caractères. Une séquence d’insertions ou de suppressions au sein d’un même bloc de texte est considérée comme une seule opération d’annulation/rétablissement.
  • Insertion ou suppression de blocs de texte. Les séquences d'insertions ou de suppressions au sein d'une même opération (par exemple, en sélectionnant puis en supprimant du texte) sont considérées comme une seule opération d'annulation/rétablissement.
  • Modifications du format des caractères de texte.
  • Modifications du format des blocs de texte.
  • Modifications du format des groupes de blocs de texte.

Voir également « QTextCursor », « QTextEdit » et «Rich Text Processing».

Documentation sur les types de membres

enum QTextDocument::FindFlag
flags QTextDocument::FindFlags

Cette énumération décrit les options disponibles pour la fonction « find » de QTextDocument. Les options peuvent être combinées entre elles à l'aide d'un opérateur « OU » à partir de la liste suivante :

ConstanteValeurDescription
QTextDocument::FindBackward0x00001Recherche vers l'arrière plutôt que vers l'avant.
QTextDocument::FindCaseSensitively0x00002Par défaut, la recherche ne tient pas compte de la casse. La spécification de cette option modifie le comportement pour effectuer une recherche sensible à la casse.
QTextDocument::FindWholeWords0x00004Fait en sorte que la recherche ne trouve que des mots complets.

Le type `FindFlags` est un `typedef` pour ` QFlags<FindFlag>`. Il stocke une combinaison « OU » de valeurs `FindFlag`.

enum QTextDocument::MarkdownFeature
flags QTextDocument::MarkdownFeatures

Cette énumération permet de sélectionner l'ensemble des fonctionnalités prises en charge lors de la lecture ou de l'écriture de Markdown.

ConstanteValeurDescription
QTextDocument::MarkdownNoHTML0x0020 | 0x0040Toutes les balises HTML présentes dans le texte Markdown seront ignorées
QTextDocument::MarkdownDialectCommonMark0Uniquement les fonctionnalités normalisées par CommonMark
QTextDocument::MarkdownDialectGitHub0x0004 | 0x0008 | 0x0400 | 0x0100 | 0x0200 | 0x0800 | 0x4000 | 0x100000La plupart des fonctionnalités du dialecte GitHub

Plus précisément, le sous-ensemble pris en charge du dialecte GitHub inclut tout ce qui est présent dans CommonMark, plus :

  • la reconnaissance des URL, des adresses « www » et des adresses e-mail, et leur transformation en liens
  • le barré
  • le soulignement (à ne pas confondre avec l'italique ; dans CommonMark, les deux sont identiques)
  • les tableaux
  • les listes de tâches
  • front matter

Les « éléments préliminaires » sont souvent des métadonnées au format YAML. Qt ne dispose pas actuellement d'un analyseur syntaxique dédié à ce format ; vous pouvez toutefois choisir un analyseur tiers, appeler QTextDocument::metaInformation() pour récupérer l'intégralité du bloc, puis invoquer votre propre analyseur une fois que Qt a analysé le fichier Markdown.

Remarque : la sortie Markdown de la fonction toMarkdown() peut actuellement inclure des fonctionnalités GitHub, même si vous essayez de les désactiver en spécifiant une autre valeur d’énumération. Ce problème sera peut-être corrigé dans une future version de Qt.

Le type `MarkdownFeatures` est un `typedef` pour ` QFlags<MarkdownFeature>`. Il stocke une combinaison « ou » de valeurs `MarkdownFeature`.

Voir également toMarkdown() et setMarkdown().

enum QTextDocument::MetaInformation

Cette énumération décrit les différents types de méta-informations pouvant être ajoutés à un document.

ConstanteValeurDescription
QTextDocument::DocumentTitle0Le titre du document.
QTextDocument::DocumentUrl1L'URL du document. La fonction loadResource() utilise cette URL comme base lors du chargement des ressources relatives.
QTextDocument::CssMedia2Cette valeur est utilisée pour sélectionner la règle « @media » correspondante, le cas échéant, dans une feuille de style CSS spécifiée lorsque la fonction setHtml() est appelée. Cette valeur d'énumération a été introduite dans Qt 6.3.
QTextDocument::FrontMatter3Cette valeur sert à sélectionner le contenu de l'en-tête, s'il y en a eu un extrait lors de l'analyse du fichier source (actuellement uniquement à partir du format Markdown). Cette valeur d'énumération a été introduite dans Qt 6.8.

Voir également ` metaInformation()`, ` setMetaInformation()` et ` setHtml()`.

[alias, since 6.1] QTextDocument::ResourceProvider

Alias de type pour std::function<QVariant(const QUrl&)>.

Ce typedef a été introduit dans Qt 6.1.

enum QTextDocument::ResourceType

Cette énumération décrit les types de ressources pouvant être chargées par la fonction loadResource() de QTextDocument ou par QTextBrowser::setSource().

ConstanteValeurDescription
QTextDocument::UnknownResource0Aucune ressource n’est chargée, ou le type de ressource est inconnu.
QTextDocument::HtmlResource1La ressource contient du code HTML.
QTextDocument::ImageResource2Les types de données actuellement pris en charge sont QMetaType::QPixmap et QMetaType::QImage. Si la variante correspondante est de type QMetaType::QByteArray, Qt tente alors de charger l’image à l’aide de QImage::loadFromData. QMetaType::QIcon n’est actuellement pas pris en charge. L’icône doit d’abord être convertie en l’un des types pris en charge, par exemple à l’aide de QIcon::pixmap.
QTextDocument::StyleSheetResource3La ressource contient du CSS.
QTextDocument::MarkdownResource4La ressource contient du Markdown.
QTextDocument::UserResource100Première valeur disponible pour les types de ressources définis par l'utilisateur.

Voir également loadResource() et QTextBrowser::sourceType().

enum QTextDocument::Stacks

ConstanteValeurDescription
QTextDocument::UndoStack0x01La pile d'annulation.
QTextDocument::RedoStack0x02La pile de reprise.
QTextDocument::UndoAndRedoStacksUndoStack | RedoStackLes piles d’annulation et de reprise.

Documentation sur les propriétés

baseUrl : QUrl

Cette propriété contient l'URL de base utilisée pour résoudre les URL de ressources relatives au sein du document.

Les URL de ressources sont résolues de manière à se trouver dans le même répertoire que la cible de l'URL de base, ce qui signifie que toute partie du chemin d'accès située après le dernier « / » sera ignorée.

URL de baseURL relativeURL résolue
file:///chemin/vers/contenuimages/logo.pngfile:///chemin/vers/images/logo.png
file:///chemin/vers/contenu/images/logo.pngfile:///chemin/vers/contenu/images/logo.png
file:///chemin/vers/contenu/index.htmlimages/logo.pngfile:///chemin/vers/le/contenu/images/logo.png
file:///chemin/vers/contenu/images/../images/logo.pngfile:///chemin/vers/contenu/images/logo.png

Fonctions d'accès :

QUrl baseUrl() const
void setBaseUrl(const QUrl &url)

Signal de notification :

void baseUrlChanged(const QUrl &url)

[read-only] blockCount : int

Cette propriété contient le nombre de blocs de texte présents dans le document.

La valeur de cette propriété n'est pas définie dans les documents contenant des tableaux ou des cadres.

Par défaut, si elle est définie, cette propriété a pour valeur 1.

Fonctions d'accès :

int blockCount() const

Voir également lineCount() et characterCount().

defaultFont : QFont

Cette propriété définit la police par défaut utilisée pour afficher le texte du document

Fonctions d'accès :

QFont defaultFont() const
void setDefaultFont(const QFont &font)

defaultStyleSheet : QString

La feuille de style par défaut s'applique à tout nouveau texte au format HTML inséré dans le document, par exemple à l'aide de setHtml() ou QTextCursor::insertHtml().

La feuille de style doit être conforme à la syntaxe CSS 2.1.

Remarque : la modification de la feuille de style par défaut n'a aucun effet sur le contenu existant du document.

Fonctions d'accès :

QString defaultStyleSheet() const
void setDefaultStyleSheet(const QString &sheet)

Voir également Sous-ensemble HTML pris en charge.

defaultTextOption : QTextOption

Cette propriété permet de définir l'option de texte par défaut pour tous les objets « QTextLayout» du document.

Lors de la création d'QTextBlocks, l'option `defaultTextOption` est définie dans leur propriété ` QTextLayout`. Cela permet de définir des propriétés globales pour le document, telles que le mode de retour à la ligne par défaut.

Fonctions d'accès :

QTextOption defaultTextOption() const
void setDefaultTextOption(const QTextOption &option)

documentMargin : qreal

La marge autour du document. La valeur par défaut est 4.

Fonctions d'Access :

qreal documentMargin() const
void setDocumentMargin(qreal margin)

indentWidth : qreal

Renvoie la largeur utilisée pour l'indentation des listes de texte et des blocs de texte.

Les propriétés d'indentation de QTextListFormat et QTextBlockFormat spécifient des multiples de cette valeur. La largeur d'indentation par défaut est de 40.

Fonctions d'accès :

qreal indentWidth() const
void setIndentWidth(qreal width)

[since 6.4] layoutEnabled : bool

Cette propriété détermine si QTextDocument doit recalculer la mise en page après chaque modification

Si cette propriété est définie sur « true », toute modification apportée au document déclenche une mise en page, ce qui garantit un fonctionnement conforme aux attentes mais prend du temps.

La désactivation temporaire de la mise en page peut permettre de gagner du temps lors de modifications multiples (non seulement le contenu textuel, mais aussi la police par défaut, l'option de texte par défaut, etc.), de sorte que le document ne soit mis en page qu'une seule fois à la fin. Cela peut s'avérer utile lorsque la largeur du texte ou la taille de la page n'est pas encore connue, par exemple.

Par défaut, cette propriété est définie sur « true ».

Cette énumération a été introduite dans Qt 6.4.

Fonctions d'accès :

bool isLayoutEnabled() const
void setLayoutEnabled(bool b)

Voir également setTextWidth.

maximumBlockCount : int

Définit la limite du nombre de blocs dans le document.

Spécifie le nombre maximal de blocs que le document peut contenir. Si le document contient plus de blocs que le nombre spécifié par cette propriété, les blocs sont supprimés à partir du début du document.

Une valeur négative ou nulle indique que le document peut contenir un nombre illimité de blocs.

La valeur par défaut est 0.

Notez que la définition de cette propriété applique immédiatement la limite au contenu du document.

La définition de cette propriété désactive également l'historique des actions « Annuler » et « Rétablir ».

Cette propriété n’est pas définie dans les documents comportant des tableaux ou des cadres.

Fonctions d’accès :

int maximumBlockCount() const
void setMaximumBlockCount(int maximum)

modified : bool

Cette propriété indique si le document a été modifié par l'utilisateur

Par défaut, cette propriété prend la valeur « false ».

Fonctions d'accès :

bool isModified() const
void setModified(bool m = true)

Voir également ` modificationChanged()`.

pageSize : QSizeF

Cette propriété contient la taille de page à utiliser pour la mise en page du document

Les unités sont déterminées par le périphérique de sortie sous-jacent. La taille est mesurée en pixels logiques lors de l'affichage à l'écran, et en points (1/72 de pouce) lors de l'impression.

Par défaut, pour un document vide nouvellement créé, cette propriété contient une taille non définie.

Fonctions d'accès :

QSizeF pageSize() const
void setPageSize(const QSizeF &size)

Voir également modificationChanged().

[read-only] size : QSizeF

Cette propriété contient la taille réelle du document. Elle équivaut à documentLayout()->documentSize();

La taille du document peut être modifiée soit en définissant une largeur de texte, soit en définissant la taille d'une page entière.

Notez que la largeur est toujours >= pageSize().width().

Par défaut, pour un document vide nouvellement créé, cette propriété contient une taille qui dépend de la configuration.

Fonctions d’accès :

QSizeF size() const

Voir également setTextWidth(), setPageSize() et idealWidth().

textWidth : qreal

La largeur du texte définit la largeur souhaitée pour le texte dans le document. Si le texte (ou le contenu en général) dépasse la largeur spécifiée, il est réparti sur plusieurs lignes et s'étend verticalement. Si le texte ne peut pas être réparti sur plusieurs lignes pour s'adapter à la largeur spécifiée, il sera plus grand et les propriétés size() et idealWidth() refléteront cette situation.

Si la largeur du texte est définie sur -1, le texte ne sera pas divisé en plusieurs lignes, sauf si cela est imposé par un saut de ligne explicite ou un nouveau paragraphe.

La valeur par défaut est -1.

La définition de la largeur du texte définit également la hauteur de la page sur -1, ce qui entraîne un étirement ou un rétrécissement continu du document dans le sens vertical. Si vous souhaitez que la mise en page du document répartisse le texte sur plusieurs pages, vous devez plutôt définir la propriété pageSize.

Fonctions d’accès :

qreal textWidth() const
void setTextWidth(qreal width)

Voir également size(), idealWidth() et pageSize().

undoRedoEnabled : bool

Cette propriété indique si les fonctions « Annuler » et « Rétablir » sont activées pour ce document

La valeur par défaut est « true ». Si cette option est désactivée, la pile d'annulation est effacée et aucun élément n'y sera ajouté.

Fonctions d'accès :

bool isUndoRedoEnabled() const
void setUndoRedoEnabled(bool enable)

useDesignMetrics : bool

Cette propriété détermine si le document utilise les métriques de conception des polices pour améliorer la précision de la mise en page du texte

Si cette propriété est définie sur « true », la mise en page utilisera les métriques de conception. Dans le cas contraire, ce sont les métriques du périphérique de dessin, telles que définies dans la méthode ` QAbstractTextDocumentLayout::setPaintDevice()`, qui seront utilisées.

L'utilisation des métriques de conception permet à une mise en page d'avoir une largeur qui ne dépend plus du hinting ni de l'arrondi des pixels. Cela signifie qu'une mise en page de texte WYSIWYG devient possible, car la largeur s'adapte de manière beaucoup plus linéaire en fonction des métriques du périphérique de rendu qu'elle ne le ferait autrement.

Par défaut, cette propriété est définie sur « false ».

Fonctions d’accès :

bool useDesignMetrics() const
void setUseDesignMetrics(bool b)

Documentation des fonctions membres

[explicit] QTextDocument::QTextDocument(QObject *parent = nullptr)

Crée un objet `QTextDocument` vide à partir de l'parent` fournie.

[explicit] QTextDocument::QTextDocument(const QString &text, QObject *parent = nullptr)

Crée un objet `QTextDocument` contenant le texte brut (non formaté) ` text ` spécifié, ainsi que l'parent` indiquée.

[virtual noexcept] QTextDocument::~QTextDocument()

Détruit le document.

void QTextDocument::addResource(int type, const QUrl &name, const QVariant &resource)

Ajoute la ressource resource au cache de ressources, en utilisant type et name comme identifiants. type doit être une valeur issue de QTextDocument::ResourceType.

Par exemple, vous pouvez ajouter une image en tant que ressource afin de la référencer depuis le document :

    document->addResource(QTextDocument::ImageResource,
        QUrl("mydata://image.png"), QVariant(image));

L'image peut être insérée dans le document à l'aide de l'API QTextCursor:

    QTextImageFormat imageFormat;
    imageFormat.setName("mydata://image.png");
    cursor.insertImage(imageFormat);

Vous pouvez également insérer des images à l’aide de la balise HTML img:

    editor->append("<img src=\"mydata://image.png\" />");

void QTextDocument::adjustSize()

Permet d'ajuster la taille du document à une taille raisonnable.

Voir également idealWidth(), textWidth et size.

QList<QTextFormat> QTextDocument::allFormats() const

Renvoie une liste des formats de texte correspondant à tous les formats utilisés dans le document.

int QTextDocument::availableRedoSteps() const

Renvoie le nombre d'étapes de redo disponibles.

Voir aussi isRedoAvailable().

int QTextDocument::availableUndoSteps() const

Renvoie le nombre d'étapes d'annulation disponibles.

Voir également la fonction « isUndoAvailable() ».

[since 6.0] qreal QTextDocument::baselineOffset() const

Renvoie le décalage de la ligne de base en %, utilisé dans la mise en page du document.

Cette fonction a été introduite dans Qt 6.0.

Voir également setBaselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() et superScriptBaseline().

QTextBlock QTextDocument::begin() const

Renvoie le premier bloc de texte du document.

Voir également firstBlock().

[signal] void QTextDocument::blockCountChanged(int newBlockCount)

Ce signal est émis lorsque le nombre total de blocs de texte dans le document change. La valeur transmise à ` newBlockCount ` correspond au nouveau total.

QChar QTextDocument::characterAt(int pos) const

Renvoie le caractère situé à la position pos, ou un caractère nul si la position est hors limites.

Voir aussi characterCount().

int QTextDocument::characterCount() const

Renvoie le nombre de caractères de ce document.

Remarque : comme un objet ` QTextDocument ` contient toujours au moins un ` QChar::ParagraphSeparator`, cette méthode renvoie au moins 1.

Voir aussi blockCount() et characterAt().

[virtual] void QTextDocument::clear()

Efface le document.

void QTextDocument::clearUndoRedoStacks(QTextDocument::Stacks stacksToClear = UndoAndRedoStacks)

Efface les piles spécifiées par ` stacksToClear`.

Cette méthode efface toutes les commandes présentes dans la pile d’annulation, la pile de rétablissement, ou les deux (par défaut). Si des commandes sont effacées, les signaux appropriés sont émis : QTextDocument::undoAvailable() ou QTextDocument::redoAvailable().

Voir également QTextDocument::undoAvailable() et QTextDocument::redoAvailable().

QTextDocument *QTextDocument::clone(QObject *parent = nullptr) const

Crée un nouvel objet ` QTextDocument ` qui est une copie de ce document texte. ` parent ` est le parent du document texte renvoyé.

[signal] void QTextDocument::contentsChange(int position, int charsRemoved, int charsAdded)

Ce signal est émis chaque fois que le contenu du document change ; par exemple, lorsqu'un texte est inséré ou supprimé, ou lorsqu'une mise en forme est appliquée.

Des informations sont fournies concernant l’ position e du caractère dans le document où la modification s’est produite, le nombre de caractères supprimés (charsRemoved) et le nombre de caractères ajoutés (charsAdded).

Le signal est émis avant que le gestionnaire de mise en page du document ne soit informé de la modification. Ce hook vous permet d’implémenter la coloration syntaxique pour le document.

Voir également QAbstractTextDocumentLayout::documentChanged() et contentsChanged().

[signal] void QTextDocument::contentsChanged()

Ce signal est émis chaque fois que le contenu du document change ; par exemple, lorsqu'on insère ou supprime du texte, ou lorsqu'on applique une mise en forme.

Voir également contentsChange().

[virtual protected] QTextObject *QTextDocument::createObject(const QTextFormat &format)

Crée et renvoie un nouvel objet document (un ` QTextObject`), à partir de l’ format fourni.

Les objets QTextObject sont toujours créés via cette méthode ; vous devez donc la réimplémenter si vous utilisez des objets texte personnalisés dans votre document.

[signal] void QTextDocument::cursorPositionChanged(const QTextCursor &cursor)

Ce signal est émis chaque fois que la position d'un curseur change à la suite d'une opération d'édition. Le curseur dont la position a changé est transmis via ` cursor`. Si le document est utilisé avec la classe ` QTextEdit ` et que vous avez besoin d'un signal lorsque le curseur est déplacé à l'aide des touches fléchées, vous pouvez utiliser le signal ` cursorPositionChanged()` dans ` QTextEdit`.

Qt::CursorMoveStyle QTextDocument::defaultCursorMoveStyle() const

Le style de déplacement du curseur par défaut est utilisé par tous les objets QTextCursor créés à partir du document. La valeur par défaut est Qt::LogicalMoveStyle.

Voir également setDefaultCursorMoveStyle().

QFont QTextDocument::defaultFont() const

Renvoie la police par défaut à utiliser dans la mise en page du document.

Remarque : fonctiongetter pour la propriété defaultFont.

Voir aussi setDefaultFont().

[static, since 6.1] QTextDocument::ResourceProvider QTextDocument::defaultResourceProvider()

Renvoie le fournisseur de ressources par défaut.

Cette fonction a été introduite dans Qt 6.1.

Voir également setDefaultResourceProvider(), resourceProvider() et loadResource().

QTextOption QTextDocument::defaultTextOption() const

L'option de texte par défaut s'applique à tous les objets « QTextLayout » du document. Cela permet de définir des propriétés globales pour le document, telles que le mode de retour à la ligne par défaut.

Remarque : fonctiongetter pour la propriété defaultTextOption.

Voir également setDefaultTextOption().

QAbstractTextDocumentLayout *QTextDocument::documentLayout() const

Renvoie la mise en page de ce document.

Voir également setDocumentLayout().

[signal] void QTextDocument::documentLayoutChanged()

Ce signal est émis lorsqu'une nouvelle mise en page est définie.

Voir également setDocumentLayout().

void QTextDocument::drawContents(QPainter *p, const QRectF &rect = QRectF())

Dessine le contenu du document à l'aide de l'p « painter », en le limitant à l' « rect ». Si l' « rect » est un rectangle nul (par défaut), le document est alors dessiné sans limitation.

QTextBlock QTextDocument::end() const

Cette fonction renvoie un bloc permettant de vérifier si l'on a atteint la fin du document lors d'une itération sur celui-ci.

for (QTextBlock it = doc->begin(); it != doc->end(); it = it.next())
    std::cout << it.text().toStdString() << "\n";

Le bloc renvoyé n'est pas valide et correspond au bloc situé après le dernier bloc du document. Vous pouvez utiliser la fonction lastBlock() pour récupérer le dernier bloc valide du document.

Voir également lastBlock().

QTextCursor QTextDocument::find(const QRegularExpression &expr, const QTextCursor &cursor, QTextDocument::FindFlags options = FindFlags()) const

Recherche la prochaine occurrence correspondant à l'expression régulière donnée, expr, au sein du même paragraphe du document.

La recherche commence à la position de l’ cursor on fournie et se poursuit vers l’avant dans le document, sauf indication contraire dans les options de recherche. Les options de recherche ( options ) déterminent le type de recherche effectué.

Renvoie un curseur avec la correspondance sélectionnée si une correspondance a été trouvée ; sinon, renvoie un curseur nul.

Si l'cursor spécifiée comporte une sélection, la recherche commence après la sélection ; sinon, elle commence à la position du curseur.

Par défaut, la recherche n’est pas sensible à la casse et peut trouver du texte n’importe où dans le document.

QTextCursor QTextDocument::find(const QRegularExpression &expr, int from = 0, QTextDocument::FindFlags options = FindFlags()) const

Recherche la prochaine occurrence correspondant à l'expression régulière donnée, expr, au sein du même paragraphe du document.

La recherche commence à la position indiquée par ` from ` et se poursuit vers l'avant dans le document, sauf indication contraire dans les options de recherche. Les ` options ` déterminent le type de recherche effectué.

Renvoie un curseur avec le résultat sélectionné si une correspondance a été trouvée ; sinon, renvoie un curseur nul.

Si la position from est égale à 0 (valeur par défaut), la recherche commence au début du document ; sinon, elle commence à la position spécifiée.

Avertissement : pour des raisons historiques, l'option de sensibilité à la casse définie sur ` expr ` est ignorée. Ce sont plutôt les paramètres ` options ` qui sont utilisés pour déterminer si la recherche tient compte de la casse ou non.

QTextCursor QTextDocument::find(const QString &subString, const QTextCursor &cursor, QTextDocument::FindFlags options = FindFlags()) const

Recherche la prochaine occurrence de la chaîne « subString » dans le document. La recherche commence à la position indiquée par « cursor » et se poursuit vers l’avant dans le document, sauf indication contraire dans les options de recherche. Les paramètres « options » déterminent le type de recherche effectuée.

Renvoie un curseur avec la correspondance sélectionnée si subString a été trouvé ; sinon, renvoie un curseur nul.

Si l'cursor on fournie comporte une sélection, la recherche commence après celle-ci ; sinon, elle commence à la position du curseur.

Par défaut, la recherche est insensible à la casse et peut trouver du texte n'importe où dans le document.

QTextCursor QTextDocument::find(const QString &subString, int position = 0, QTextDocument::FindFlags options = FindFlags()) const

Recherche la prochaine occurrence de la chaîne « subString » dans le document. La recherche commence à l’ position indiquée et se poursuit vers l’avant dans le document, sauf indication contraire dans les options de recherche. Les paramètres « options » déterminent le type de recherche effectuée.

Renvoie un curseur avec la correspondance sélectionnée si subString a été trouvé ; sinon, renvoie un curseur nul.

Si l’ position est égal à 0 (valeur par défaut), la recherche commence au début du document ; sinon, elle commence à la position spécifiée.

Il s’agit d’une fonction surchargée.

QTextBlock QTextDocument::findBlock(int pos) const

Renvoie le bloc de texte contenant le -ième caractère de « pos ».

QTextBlock QTextDocument::findBlockByLineNumber(int lineNumber) const

Renvoie le bloc de texte contenant le texte spécifié lineNumber.

Voir aussi QTextBlock::firstLineNumber().

QTextBlock QTextDocument::findBlockByNumber(int blockNumber) const

Renvoie le bloc de texte avec l'blockNumber spécifiée.

Voir aussi ` QTextBlock::blockNumber()`.

QTextBlock QTextDocument::firstBlock() const

Renvoie le premier bloc de texte du document.

qreal QTextDocument::idealWidth() const

Renvoie la largeur idéale du document texte. La largeur idéale correspond à la largeur effectivement utilisée par le document, sans tenir compte des alignements facultatifs. Elle est toujours inférieure ou égale à la valeur renvoyée par la fonction ` size()`.width().

Voir également adjustSize() et textWidth.

bool QTextDocument::isEmpty() const

Renvoie « true » si le document est vide ; sinon, renvoie « false ».

bool QTextDocument::isRedoAvailable() const

Renvoie « true » si la fonction « redo » est disponible ; sinon, renvoie « false ».

Voir également isUndoAvailable() et availableRedoSteps().

bool QTextDocument::isUndoAvailable() const

Renvoie « true » si la fonction « undo » est disponible ; sinon, renvoie « false ».

Voir également isRedoAvailable() et availableUndoSteps().

QTextBlock QTextDocument::lastBlock() const

Renvoie le dernier bloc de texte (valide) du document.

int QTextDocument::lineCount() const

Renvoie le nombre de lignes de ce document (si la mise en page le permet). Sinon, cette valeur correspond au nombre de blocs.

Voir également blockCount() et characterCount().

[virtual protected invokable] QVariant QTextDocument::loadResource(int type, const QUrl &name)

Charge les données de l'type spécifiée à partir de la ressource dont l'name est indiquée.

Cette fonction est appelée par le moteur de texte enrichi pour demander des données qui ne sont pas directement stockées par ` QTextDocument`, mais qui lui sont néanmoins associées. Par exemple, les images sont référencées indirectement par l’attribut `name` d’un objet ` QTextImageFormat `.

Lorsqu’elle est appelée par Qt, ` type ` est l’une des valeurs de ` QTextDocument::ResourceType`.

Si ` QTextDocument ` est un objet enfant d’un ` QObject ` disposant d’une méthode `loadResource` invocable, telle que ` QTextEdit`, ` QTextBrowser ` ou ` QTextDocument ` elle-même, l’implémentation par défaut tente alors de récupérer les données auprès du parent.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également QTextDocument::ResourceProvider.

void QTextDocument::markContentsDirty(int position, int length)

Marque comme « modifiés » les contenus spécifiés par les attributs position et length, indiquant ainsi au document qu'il doit être réorganisé.

QString QTextDocument::metaInformation(QTextDocument::MetaInformation info) const

Renvoie des méta-informations sur le document du type spécifié par info.

Voir également setMetaInformation().

[signal] void QTextDocument::modificationChanged(bool changed)

Ce signal est émis chaque fois que le contenu du document subit une modification qui affecte son état de modification. Si la valeur de ` changed ` est `true`, le document a été modifié ; dans le cas contraire, elle est `false`.

Par exemple, si l’on appelle la méthode ` setModified(false)` sur un document puis que l’on insère du texte, le signal est émis. Si l’on annule cette opération, ce qui ramène le document à son état d’origine non modifié, le signal est à nouveau émis.

QTextObject *QTextDocument::object(int objectIndex) const

Renvoie l'objet texte associé à l'objectIndex donné.

QTextObject *QTextDocument::objectForFormat(const QTextFormat &f) const

Renvoie l'objet texte associé au format f.

int QTextDocument::pageCount() const

renvoie le nombre de pages de ce document.

void QTextDocument::print(QPagedPaintDevice *printer) const

Imprime le document sur l'printer spécifiée. L'QPagedPaintDevice doit être configurée avant d'être utilisée avec cette fonction.

Il s’agit simplement d’une méthode pratique permettant d’imprimer l’intégralité du document sur l’imprimante.

Si le document est déjà paginé selon une hauteur spécifiée dans la propriété pageSize(), il est imprimé tel quel.

Si le document n’est pas paginé, comme c’est le cas par exemple pour un document utilisé dans un ` QTextEdit`, une copie temporaire du document est alors créée et cette copie est divisée en plusieurs pages en fonction de la taille du `paperRect()` du périphérique d’impression. Par défaut, une marge de 2 cm est définie autour du contenu du document. De plus, le numéro de la page en cours est imprimé au bas de chaque page.

Voir également QTextEdit::print().

void QTextDocument::redo(QTextCursor *cursor)

Répète la dernière opération d'édition effectuée sur le document si redo is available.

L'cursor fourni est positionné à la fin de l'emplacement où l'opération d'édition a été refaite.

[slot] void QTextDocument::redo()

Répète la dernière opération d'édition effectuée sur le document si redo is available.

Remarque : ce slot est surchargé. Pour vous connecter à ce slot :

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        textDocument, qOverload<>(&QTextDocument::redo));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        textDocument, [receiver = textDocument]() { receiver->redo(); });
Pour plus d’exemples et d’approches, consultez la section « Connexion à des slots surchargés ».

[signal] void QTextDocument::redoAvailable(bool available)

Ce signal est émis dès que les opérations de réexécution deviennent disponibles (available est vrai) ou indisponibles (available est faux).

QVariant QTextDocument::resource(int type, const QUrl &name) const

Renvoie les données de l'type spécifié à partir de la ressource dont l'name est indiquée.

Cette fonction est appelée par le moteur de texte enrichi pour demander des données qui ne sont pas directement stockées par QTextDocument, mais qui lui sont néanmoins associées. Par exemple, les images sont référencées indirectement par l’attribut « name » d’un objet QTextImageFormat.

Les ressources sont mises en cache en interne dans le document. Si une ressource est introuvable dans le cache, la méthode ` loadResource ` est appelée pour tenter de la charger. ` loadResource ` doit alors utiliser ` addResource ` pour ajouter la ressource au cache.

Si la méthode ` loadResource ` ne parvient pas à charger la ressource, la méthode ` resourceProvider `, puis enfin la méthode ` defaultResourceProvider ` seront appelées, si elles sont définies. Notez que le résultat fourni par le fournisseur ne sera pas ajouté automatiquement au cache.

Voir également QTextDocument::ResourceType et resourceProvider().

[since 6.1] QTextDocument::ResourceProvider QTextDocument::resourceProvider() const

Renvoie le fournisseur de ressources associé à ce document texte.

Cette fonction a été introduite dans Qt 6.1.

Voir également setResourceProvider(), defaultResourceProvider() et loadResource().

int QTextDocument::revision() const

Renvoie la révision du document (si la fonction « Annuler » est activée).

La révision augmente systématiquement lorsqu’un document non modifié est édité.

Voir également QTextBlock::revision() et isModified().

QTextFrame *QTextDocument::rootFrame() const

Renvoie le cadre racine du document.

[since 6.0] void QTextDocument::setBaselineOffset(qreal baseline)

Définit la ligne de base en pourcentage de la hauteur de la police à utiliser dans la mise en page du document, selon la méthode « baseline ». La valeur par défaut est 0. Une valeur positive déplace le texte vers le haut, du pourcentage correspondant ; une valeur négative le déplace vers le bas.

Cette fonction a été introduite dans Qt 6.0.

Voir également baselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() et superScriptBaseline().

void QTextDocument::setDefaultCursorMoveStyle(Qt::CursorMoveStyle style)

Définit le style de déplacement par défaut du curseur sur la valeur indiquée : style.

Voir aussi defaultCursorMoveStyle().

void QTextDocument::setDefaultFont(const QFont &font)

Définit l'font par défaut à utiliser dans la mise en page du document.

Remarque : fonctionde définition de la propriété defaultFont.

Voir aussi defaultFont().

[static, since 6.1] void QTextDocument::setDefaultResourceProvider(const QTextDocument::ResourceProvider &provider)

Définit le fournisseur de ressources par défaut sur provider.

Le fournisseur par défaut sera utilisé par tous les QTextDocuments pour lesquels aucun fournisseur n'a été explicitement défini.

Cette fonction a été introduite dans Qt 6.1.

Voir également defaultResourceProvider(), setResourceProvider() et loadResource().

void QTextDocument::setDefaultTextOption(const QTextOption &option)

Définit l'option de texte par défaut sur « option ».

Remarque : fonctionde définition de la propriété defaultTextOption.

Voir aussi defaultTextOption().

void QTextDocument::setDocumentLayout(QAbstractTextDocumentLayout *layout)

Configure le document pour qu'il utilise la mise en page spécifiée layout. La mise en page précédente est supprimée.

Voir également documentLayoutChanged().

void QTextDocument::setHtml(const QString &html)

Remplace tout le contenu du document par le texte au format HTML fourni dans la chaîne « html ». L'historique des annulations et des reprises est réinitialisé lorsque cette fonction est appelée.

La mise en forme HTML est respectée autant que possible ; par exemple, « <b>bold</b> text » produira un texte dans lequel le premier mot aura une épaisseur de police lui donnant un aspect gras : «bold text ».

Pour sélectionner une règle CSS « media » autre que la règle par défaut « screen », utilisez setMetaInformation() avec «CssMedia » comme paramètre « info ».

Remarque : il incombe à l’appelant de s’assurer que le texte est correctement décodé lorsqu’un QString contenant du code HTML est créé et transmis à la fonction setHtml().

Voir également setPlainText(), Sous-ensemble HTML pris en charge et setMetaInformation().

void QTextDocument::setIndentWidth(qreal width)

Définit la valeur « width » utilisée pour l’indentation des listes de texte et des blocs de texte.

Les propriétés d'indentation de « QTextListFormat » et « QTextBlockFormat » spécifient des multiples de cette valeur. La largeur d'indentation par défaut est de 40.

Remarque : fonctionde définition de la propriété indentWidth.

Voir aussi indentWidth().

void QTextDocument::setMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = MarkdownDialectGitHub)

Remplace l'intégralité du contenu du document par le texte au format Markdown fourni dans la chaîne « markdown », en prenant en charge les options « features » indiquées. Par défaut, toutes les fonctionnalités Markdown de type GitHub prises en charge sont incluses ; passez « MarkdownDialectCommonMark » pour une analyse plus basique.

La mise en forme Markdown est respectée autant que possible ; par exemple, « *texte en gras* » produira un texte dans lequel le premier mot aura une épaisseur de police lui donnant un aspect mis en évidence.

L’analyse du code HTML inclus dans la chaîne « markdown » est gérée de la même manière que dans « setHtml » ; toutefois, la mise en forme Markdown à l’intérieur des blocs HTML n’est pas prise en charge.

Certaines fonctionnalités de l’analyseur peuvent être activées ou désactivées via l’argument features. La valeur par défaut est MarkdownDialectGitHub.

L'historique des annulations et des reprises est réinitialisé lorsque cette fonction est appelée.

void QTextDocument::setMetaInformation(QTextDocument::MetaInformation info, const QString &string)

Définit les métadonnées du document, dont le type est spécifié par ` info `, sur la valeur fournie par ` string`.

Voir également metaInformation().

void QTextDocument::setPlainText(const QString &text)

Remplace l'intégralité du contenu du document par le texte brut fourni text. L'historique des annulations et des reprises est réinitialisé lorsque cette fonction est appelée.

Voir aussi setHtml().

[since 6.1] void QTextDocument::setResourceProvider(const QTextDocument::ResourceProvider &provider)

Définit le fournisseur de ressources du document texte sur provider.

Cette fonction a été introduite dans Qt 6.1.

Voir également resourceProvider() et loadResource().

[since 6.0] void QTextDocument::setSubScriptBaseline(qreal baseline)

Définit la ligne de base par défaut des indices, exprimée en pourcentage de la hauteur de la police, à utiliser dans la mise en page du document, à l'adresse baseline. La valeur par défaut est de 16,67 % (1/6 de la hauteur).

Cette fonction a été introduite dans Qt 6.0.

Voir également subScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() et baselineOffset().

[since 6.0] void QTextDocument::setSuperScriptBaseline(qreal baseline)

Définit la ligne de base par défaut des exposants sous forme de pourcentage de la hauteur de la police, à utiliser dans la mise en page du document : baseline. La valeur par défaut est 50 % (la moitié de la hauteur).

Cette fonction a été introduite dans Qt 6.0.

Voir également superScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() et baselineOffset().

[since 6.0] qreal QTextDocument::subScriptBaseline() const

Renvoie la ligne de base de l'exposant sous forme de pourcentage de la hauteur de police utilisée dans la mise en page du document.

Cette fonction a été introduite dans Qt 6.0.

Voir également setSubScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() et baselineOffset().

[since 6.0] qreal QTextDocument::superScriptBaseline() const

Renvoie la ligne de base de l'exposant sous forme de pourcentage de la hauteur de police utilisée dans la mise en page du document.

Cette fonction a été introduite dans Qt 6.0.

Voir également setSuperScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() et baselineOffset().

QString QTextDocument::toHtml() const

Renvoie une chaîne contenant une représentation HTML du document.

Le contenu du document spécifie que son encodage est UTF-8. Si vous convertissez ultérieurement la chaîne HTML renvoyée en tableau d'octets pour la transmettre sur un réseau ou pour l'enregistrer sur le disque, vous devez utiliser la fonction ` QString::toUtf8()` pour convertir la chaîne en ` QByteArray`.

Voir également «Sous-ensemble HTML pris en charge ».

QString QTextDocument::toMarkdown(QTextDocument::MarkdownFeatures features = MarkdownDialectGitHub) const

Renvoie une chaîne contenant une représentation Markdown du document avec l'features spécifiée, ou une chaîne vide si l'écriture échoue pour une raison quelconque.

Voir également setMarkdown.

QString QTextDocument::toPlainText() const

Renvoie le texte brut contenu dans le document. Si vous souhaitez obtenir les informations de mise en forme, utilisez plutôt la fonction ` QTextCursor `.

Cette fonction renvoie le même résultat que toRawText(), mais remplace certains caractères Unicode par leurs équivalents ASCII. En particulier, l'espace insécable (U+00A0) est remplacé par un espace normal (U+0020), et les séparateurs de paragraphe (U+2029) et de ligne (U+2028) sont tous deux remplacés par un saut de ligne (U+000A). Si vous avez besoin du contenu exact du document, utilisez plutôt la fonction toRawText().

Remarque : les objetsintégrés , tels que les images, sont représentés par la valeur Unicode U+FFFC (CARACTÈRE DE REMPLACEMENT D'OBJET).

Voir également toHtml().

QString QTextDocument::toRawText() const

Renvoie le texte brut contenu dans le document, sans aucune information de mise en forme. Si vous souhaitez obtenir des informations de mise en forme, utilisez plutôt la fonction « QTextCursor ».

Voir également toPlainText().

void QTextDocument::undo(QTextCursor *cursor)

Annule la dernière opération d'édition effectuée sur le document, si la fonction d'annulation est disponible. L'cursor fourni est positionné à la fin de l'emplacement où l'opération d'édition a été annulée.

Pour plus de détails, consultez la documentation du framework Qt Undo.

Voir également ` undoAvailable()` et ` isUndoRedoEnabled()`.

[slot] void QTextDocument::undo()

Remarque : cet emplacement est surchargé. Pour vous connecter à cet emplacement :

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        textDocument, qOverload<>(&QTextDocument::undo));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        textDocument, [receiver = textDocument]() { receiver->undo(); });
Pour plus d’exemples et d’approches, consultez la section « Connexion à des slots surchargés ».

[signal] void QTextDocument::undoAvailable(bool available)

Ce signal est émis dès que les opérations d'annulation deviennent disponibles (available est vrai) ou indisponibles (available est faux).

Pour plus de détails, consultez la documentation du framework Qt Undo.

Voir également undo() et isUndoRedoEnabled().

[signal] void QTextDocument::undoCommandAdded()

Ce signal est émis chaque fois qu'un nouveau niveau d'annulation est ajouté à l'QTextDocument.

© 2026 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.