QTextEdit Class

Documentation sur les fonctions membres

[explicit] QTextEdit::QTextEdit(QWidget *parent = nullptr)

Crée un objet QTextEdit vide dont le parent est parent.

[explicit] QTextEdit::QTextEdit(const QString &text, QWidget *parent = nullptr)

Crée un objet QTextEdit dont le parent est parent. La zone d'édition affichera le texte text. Le texte est interprété comme du code HTML.

[virtual noexcept] QTextEdit::~QTextEdit()

Destructeur.

Qt::Alignment QTextEdit::alignment() const

Renvoie l'alignement du paragraphe actuel.

Voir aussi setAlignment().

QString QTextEdit::anchorAt(const QPoint &pos) const

Renvoie la référence de l'ancrage situé à la position pos, ou une chaîne vide s'il n'existe aucun ancrage à cet endroit.

[slot] void QTextEdit::append(const QString &text)

Ajoute un nouveau paragraphe contenant « text » à la fin du texte en cours d'édition.

Voir également ` currentCharFormat()` et ` QTextCursor::blockFormat()`.

[virtual protected] bool QTextEdit::canInsertFromMimeData(const QMimeData *source) const

Cette fonction renvoie ` true ` si le contenu de l'objet de données MIME, spécifié par ` source`, peut être décodé et inséré dans le document. Elle est appelée, par exemple, lorsqu'au cours d'une opération de glisser-déposer, la souris entre dans ce widget et qu'il est nécessaire de déterminer s'il est possible d'accepter l'opération de glisser-déposer.

Réimplémentez cette fonction pour activer la prise en charge du glisser-déposer pour d'autres types MIME.

bool QTextEdit::canPaste() const

Indique si du texte peut être collé depuis le presse-papiers dans la zone de saisie.

[override virtual protected] void QTextEdit::changeEvent(QEvent *e)

Réimplémente : QFrame::changeEvent(QEvent *ev).

[slot] void QTextEdit::clear()

Supprime tout le texte contenu dans la zone d'édition.

Remarques :

• L'historique des annulations et des reprises est également effacé.
• currentCharFormat() est réinitialisé, sauf si textCursor() se trouve déjà au début du document.

Voir également cut(), setPlainText() et setHtml().

[override virtual protected] void QTextEdit::contextMenuEvent(QContextMenuEvent *event)

Réimplémente : QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e).

Affiche le menu contextuel standard créé avec createStandardContextMenu().

Si vous ne souhaitez pas que le champ de saisie de texte dispose d’un menu contextuel, vous pouvez définir son contextMenuPolicy sur Qt::NoContextMenu. Si vous souhaitez personnaliser le menu contextuel, réimplémentez cette fonction. Si vous souhaitez étendre le menu contextuel standard, réimplémentez cette fonction, appelez createStandardContextMenu() et étendez le menu renvoyé.

Les informations relatives à l’événement sont transmises via l’objet ` event `.

void MyTextEdit::contextMenuEvent(QContextMenuEvent *event)
{
    QMenu *menu = createStandardContextMenu();
    menu->addAction(tr("My Menu Item"));
    //...
    menu->exec(event->globalPos());
    delete menu;
}

[slot] void QTextEdit::copy()

Copie le texte sélectionné dans le presse-papiers.

Voir aussi copyAvailable().

[signal] void QTextEdit::copyAvailable(bool yes)

Ce signal est émis lorsqu'un texte est sélectionné ou désélectionné dans la zone d'édition de texte.

Lorsqu'un texte est sélectionné, ce signal est émis avec la propriété « yes » définie sur « true ». Si aucun texte n'a été sélectionné ou si le texte sélectionné est désélectionné, ce signal est émis avec la propriété « yes » définie sur « false ».

Si ` yes ` est vrai, alors ` copy()` peut être utilisé pour copier la sélection dans le presse-papiers. Si ` yes ` est faux, alors ` copy()` ne fait rien.

Voir également selectionChanged().

[virtual protected] QMimeData *QTextEdit::createMimeDataFromSelection() const

Cette fonction renvoie un nouvel objet de données MIME représentant le contenu de la sélection actuelle de la zone d'édition de texte. Elle est appelée lorsque la sélection doit être encapsulée dans un nouvel objet ` QMimeData ` ; par exemple, lorsqu'une opération de glisser-déposer est lancée ou lorsque des données sont copiées dans le presse-papiers.

Si vous réimplémentez cette fonction, notez que la propriété de l’objet ` QMimeData ` renvoyé est transférée à l’appelant. La sélection peut être récupérée à l’aide de la fonction ` textCursor()`.

QMenu *QTextEdit::createStandardContextMenu()

Cette fonction crée le menu contextuel standard qui s'affiche lorsque l'utilisateur clique avec le bouton droit de la souris sur la zone d'édition de texte. Elle est appelée depuis le gestionnaire par défaut ` contextMenuEvent()`. La propriété du menu contextuel est transférée à l'appelant.

Nous vous recommandons d’utiliser plutôt la version createStandardContextMenu(QPoint), qui activera les actions dépendant de l’emplacement où l’utilisateur a cliqué.

QMenu *QTextEdit::createStandardContextMenu(const QPoint &position)

Cette fonction crée le menu contextuel standard qui s'affiche lorsque l'utilisateur clique avec le bouton droit de la souris sur la zone d'édition de texte. Elle est appelée depuis le gestionnaire par défaut ` contextMenuEvent()` et reçoit en paramètre ` position `, qui correspond aux coordonnées dans le document de l'endroit où la souris a cliqué. Cela permet d'activer des actions qui dépendent de la position où l'utilisateur a cliqué. La propriété du menu contextuel est transférée à l'appelant.

QTextCharFormat QTextEdit::currentCharFormat() const

Renvoie le format de caractères utilisé lors de l'insertion de nouveau texte.

Voir aussi setCurrentCharFormat().

[signal] void QTextEdit::currentCharFormatChanged(const QTextCharFormat &f)

Ce signal est émis lorsque le format du caractère actuel a changé, par exemple à la suite d'un déplacement du curseur.

Le nouveau format est f.

Voir également setCurrentCharFormat().

QFont QTextEdit::currentFont() const

Renvoie la police du format actuel.

Voir également setCurrentFont(), setFontFamily() et setFontPointSize().

QTextCursor QTextEdit::cursorForPosition(const QPoint &pos) const

renvoie un objet de type « QTextCursor » situé à la position pos (en coordonnées de la fenêtre d'affichage).

[signal] void QTextEdit::cursorPositionChanged()

Ce signal est émis chaque fois que la position du curseur change.

QRect QTextEdit::cursorRect() const

renvoie un rectangle (en coordonnées de la fenêtre d'affichage) qui englobe le curseur de la zone d'édition de texte.

QRect QTextEdit::cursorRect(const QTextCursor &cursor) const

renvoie un rectangle (en coordonnées de la fenêtre d'affichage) qui englobe l'cursor.

[slot] void QTextEdit::cut()

Copie le texte sélectionné dans le presse-papiers et le supprime de la zone d'édition.

S'il n'y a pas de texte sélectionné, rien ne se passe.

Voir également copy() et paste().

[override virtual protected] void QTextEdit::dragEnterEvent(QDragEnterEvent *e)

Réimplémente : QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event).

[override virtual protected] void QTextEdit::dragLeaveEvent(QDragLeaveEvent *e)

Réimplémente : QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event).

[override virtual protected] void QTextEdit::dragMoveEvent(QDragMoveEvent *e)

Réimplémente : QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event).

[override virtual protected] void QTextEdit::dropEvent(QDropEvent *e)

Réimplémente : QAbstractScrollArea::dropEvent(QDropEvent *event).

void QTextEdit::ensureCursorVisible()

S'assure que le curseur est visible en faisant défiler la zone de saisie si nécessaire.

QList<QTextEdit::ExtraSelection> QTextEdit::extraSelections() const

Renvoie les sélections supplémentaires précédemment définies.

Voir aussi setExtraSelections().

bool QTextEdit::find(const QString &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

Recherche l'occurrence suivante de la chaîne « exp » à l'aide de l'options fournie. Renvoie « true » si « exp » a été trouvé et positionne le curseur sur l'occurrence trouvée ; sinon, renvoie « false ».

bool QTextEdit::find(const QRegularExpression &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

Recherche l'occurrence suivante correspondant à l'expression régulière exp, en utilisant l'options fournie.

Renvoie « true » si une correspondance a été trouvée et place le curseur sur cette correspondance ; sinon, renvoie « false ».

[override virtual protected] void QTextEdit::focusInEvent(QFocusEvent *e)

Réimplémente : QWidget::focusInEvent(QFocusEvent *event).

[override virtual protected] bool QTextEdit::focusNextPrevChild(bool next)

Réimplémente : QWidget::focusNextPrevChild(bool next).

[override virtual protected] void QTextEdit::focusOutEvent(QFocusEvent *e)

Réimplémente : QWidget::focusOutEvent(QFocusEvent *event).

QString QTextEdit::fontFamily() const

Renvoie la famille de polices du format actuel.

Voir également setFontFamily(), setCurrentFont() et setFontPointSize().

bool QTextEdit::fontItalic() const

Renvoie « true » si la police du format actuel est en italique ; sinon, renvoie « false ».

Voir aussi setFontItalic().

qreal QTextEdit::fontPointSize() const

Renvoie la taille en points de la police du format actuel.

Voir également setFontFamily(), setCurrentFont() et setFontPointSize().

bool QTextEdit::fontUnderline() const

Renvoie « true » si la police du format actuel est soulignée ; sinon, renvoie « false ».

Voir aussi setFontUnderline().

int QTextEdit::fontWeight() const

Renvoie l'épaisseur de la police du format actuel.

Voir également setFontWeight(), setCurrentFont(), setFontPointSize() et QFont::Weight.

[override virtual protected] void QTextEdit::inputMethodEvent(QInputMethodEvent *e)

Réimplémente : QWidget::inputMethodEvent(QInputMethodEvent *event).

[override virtual] QVariant QTextEdit::inputMethodQuery(Qt::InputMethodQuery property) const

Réimplémente : ` QWidget::inputMethodQuery` (requête `Qt::InputMethodQuery` de type `const`).

[virtual protected] void QTextEdit::insertFromMimeData(const QMimeData *source)

Cette fonction insère le contenu de l'objet de données MIME, spécifié par ` source`, dans le champ de saisie à la position actuelle du curseur. Elle est appelée chaque fois qu'un texte est inséré à la suite d'une opération de collage à partir du presse-papiers, ou lorsque le champ de saisie accepte des données issues d'une opération de glisser-déposer.

Réimplémentez cette fonction pour activer la prise en charge du glisser-déposer pour d'autres types MIME.

[slot] void QTextEdit::insertHtml(const QString &text)

Zone de remplacement pratique permettant d'insérer text — dont le format est supposé être HTML — à la position actuelle du curseur.

Cela équivaut à :

edit->textCursor().insertHtml(fragment);

[slot] void QTextEdit::insertPlainText(const QString &text)

Fonction pratique permettant d'insérer « text » à l'emplacement actuel du curseur.

Cela revient à

edit->textCursor().insertText(text);

[override virtual protected] void QTextEdit::keyPressEvent(QKeyEvent *e)

Réimplémente : QAbstractScrollArea::keyPressEvent(QKeyEvent *e).

[override virtual protected] void QTextEdit::keyReleaseEvent(QKeyEvent *e)

Réimplémente : QWidget::keyReleaseEvent(QKeyEvent *event).

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

Charge la ressource spécifiée par les paramètres type et name fournis.

Cette fonction est une extension de QTextDocument::loadResource().

Voir également QTextDocument::loadResource().

void QTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

Intègre les propriétés spécifiées dans modifier au format de caractère actuel en appelant la fonction QTextCursor::mergeCharFormat sur le curseur de l'éditeur. Si l'éditeur comporte une sélection, les propriétés de modifier sont directement appliquées à cette sélection.

Voir également QTextCursor::mergeCharFormat().

[override virtual protected] void QTextEdit::mouseDoubleClickEvent(QMouseEvent *e)

Réimplémente : QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e).

[override virtual protected] void QTextEdit::mouseMoveEvent(QMouseEvent *e)

Réimplémente : QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e).

[override virtual protected] void QTextEdit::mousePressEvent(QMouseEvent *e)

Réimplémente : QAbstractScrollArea::mousePressEvent(QMouseEvent *e).

[override virtual protected] void QTextEdit::mouseReleaseEvent(QMouseEvent *e)

Réimplémente : QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e).

void QTextEdit::moveCursor(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor)

Déplace le curseur en appliquant l'operation spécifiée.

Si ` mode ` est ` QTextCursor::KeepAnchor`, le curseur sélectionne le texte sur lequel il passe. Cela produit le même effet que lorsque l'utilisateur maintient la touche Maj enfoncée et déplace le curseur à l'aide des touches de navigation.

Voir également ` QTextCursor::movePosition()`.

[override virtual protected] void QTextEdit::paintEvent(QPaintEvent *event)

Réimplémentation de : QAbstractScrollArea::paintEvent(QPaintEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements de dessin transmis via ` event`. Il n'est généralement pas nécessaire de réimplémenter cette fonction dans une sous-classe de ` QTextEdit`.

[slot] void QTextEdit::paste()

Colle le texte du presse-papiers dans la zone d'édition à la position actuelle du curseur.

S'il n'y a pas de texte dans le presse-papiers, rien ne se passe.

Pour modifier le comportement de cette fonction, c'est-à-dire pour définir ce que QTextEdit peut coller et comment il est collé, réimplémentez les fonctions virtuelles canInsertFromMimeData() et insertFromMimeData().

Voir également cut() et copy().

void QTextEdit::print(QPagedPaintDevice *printer) const

Fonction pratique permettant d'imprimer le document de l'objet TextEdit vers l'printer spécifiée. Cela revient à appeler directement la méthode print sur le document, à la différence près que cette fonction prend également en charge QPrinter::Selection comme plage d'impression.

Voir également QTextDocument::print().

[slot] void QTextEdit::redo()

Répète la dernière opération.

S'il n'y a aucune opération à refaire, c'est-à-dire s'il n'y a aucune étape de refaire dans l'historique des annulations/reprises, rien ne se passe.

Voir également undo().

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

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

[override virtual protected] void QTextEdit::resizeEvent(QResizeEvent *e)

Réimplémente : QAbstractScrollArea::resizeEvent(QResizeEvent *event).

[override virtual protected] void QTextEdit::scrollContentsBy(int dx, int dy)

Réimplémentation de : QAbstractScrollArea::scrollContentsBy(int dx, int dy).

[slot] void QTextEdit::scrollToAnchor(const QString &name)

Fait défiler la zone d'édition de texte de manière à ce que l'ancre dont l'name est indiquée soit visible ; ne fait rien si l'name est vide, si elle est déjà visible ou si elle est introuvable.

[slot] void QTextEdit::selectAll()

Sélectionne tout le texte.

Voir également copy(), cut() et textCursor().

[signal] void QTextEdit::selectionChanged()

Ce signal est émis chaque fois que la sélection change.

Voir également copyAvailable().

[slot] void QTextEdit::setAlignment(Qt::Alignment a)

Définit l'alignement du paragraphe actuel sur « a ». Les alignements valides sont « Qt::AlignLeft », « Qt::AlignRight », « Qt::AlignJustify » et « Qt::AlignCenter » (qui centre horizontalement).

Voir également alignment().

void QTextEdit::setCurrentCharFormat(const QTextCharFormat &format)

Définit le format de caractères à utiliser lors de l'insertion de nouveau texte dans format en appelant la fonction ` QTextCursor::setCharFormat()` sur le curseur de l'éditeur. Si l'éditeur comporte une sélection, le format de caractères est directement appliqué à cette sélection.

Voir également currentCharFormat().

[slot] void QTextEdit::setCurrentFont(const QFont &f)

Définit la police du format actuel sur « f ».

Voir également currentFont(), setFontPointSize() et setFontFamily().

void QTextEdit::setExtraSelections(const QList<QTextEdit::ExtraSelection> &selections)

Cette fonction permet de marquer temporairement certaines zones du document avec une couleur donnée, spécifiée sous la forme selections. Cela peut s'avérer utile, par exemple, dans un éditeur de programmation pour surligner une ligne entière de texte avec une couleur d'arrière-plan donnée afin d'indiquer la présence d'un point d'arrêt.

Voir également ` QTextEdit::ExtraSelection ` et ` extraSelections()`.

[slot] void QTextEdit::setFontFamily(const QString &fontFamily)

Définit la famille de polices du format actuel sur « fontFamily ».

Voir également fontFamily() et setCurrentFont().

[slot] void QTextEdit::setFontItalic(bool italic)

Si italic est vrai, définit le format actuel en italique ; sinon, définit le format actuel en caractères normaux.

Voir aussi fontItalic().

[slot] void QTextEdit::setFontPointSize(qreal s)

Définit la taille en points du format actuel sur s.

Notez que si s est égal à zéro ou à une valeur négative, le comportement de cette fonction n’est pas défini.

Voir également fontPointSize(), setCurrentFont() et setFontFamily().

[slot] void QTextEdit::setFontUnderline(bool underline)

Si underline est vrai, définit le format actuel sur « souligné » ; sinon, définit le format actuel sur « non souligné ».

Voir également fontUnderline().

[slot] void QTextEdit::setFontWeight(int weight)

Définit l'épaisseur de la police du format actuel sur la valeur indiquée weight, cette valeur se situant dans la plage définie par l'énumération QFont::Weight.

Voir également fontWeight(), setCurrentFont() et setFontFamily().

[slot] void QTextEdit::setPlainText(const QString &text)

Remplace le contenu du champ de saisie par la chaîne « text ». Tout texte préexistant est supprimé.

Remarques :

• text est interprété comme du texte brut.
• L'historique des annulations et des reprises est également effacé.
• currentCharFormat() est réinitialisé, sauf si textCursor() se trouve déjà au début du document.

Voir aussi toPlainText().

[slot] void QTextEdit::setText(const QString &text)

Définit l'text de la zone d'édition de texte. Le texte peut être du texte brut ou du code HTML ; la zone d'édition tentera de deviner le format approprié.

Utilisez directement les méthodes ` setHtml()` ou ` setPlainText()` pour éviter que la zone d'édition ne devine le format.

Voir également toPlainText() et toHtml().

[slot] void QTextEdit::setTextBackgroundColor(const QColor &c)

Définit la couleur d'arrière-plan du texte du format actuel sur « c ».

Voir également textBackgroundColor().

[slot] void QTextEdit::setTextColor(const QColor &c)

Définit la couleur du texte du format actuel sur c.

Voir également textColor().

void QTextEdit::setTextCursor(const QTextCursor &cursor)

Définit l'cursor visible.

Voir aussi textCursor().

[override virtual protected] void QTextEdit::showEvent(QShowEvent *)

Réimplémente : QWidget::showEvent(QShowEvent *event).

QColor QTextEdit::textBackgroundColor() const

Renvoie la couleur d'arrière-plan du texte du format actuel.

Voir aussi setTextBackgroundColor().

[signal] void QTextEdit::textChanged()

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.

QColor QTextEdit::textColor() const

Renvoie la couleur du texte du format actuel.

Voir aussi setTextColor().

QTextCursor QTextEdit::textCursor() const

Renvoie une copie de l'objet ` QTextCursor ` représentant le curseur actuellement visible. Notez que les modifications apportées au curseur renvoyé n'affectent pas le curseur de ` QTextEdit` ; utilisez ` setTextCursor()` pour mettre à jour le curseur visible.

Voir également setTextCursor().

QString QTextEdit::toPlainText() const

QString QTextEdit::toPlainText() const

Renvoie le contenu du champ de saisie sous forme de texte brut.

Voir aussi QTextEdit::setPlainText().

[slot] void QTextEdit::undo()

Annule la dernière opération.

S'il n'y a aucune opération à annuler, c'est-à-dire s'il n'y a aucune étape d'annulation dans l'historique des annulations/rétablissements, rien ne se passe.

Voir également redo().

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

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

[override virtual protected] void QTextEdit::wheelEvent(QWheelEvent *e)

Réimplémente : QAbstractScrollArea::wheelEvent(QWheelEvent *e).

[slot] void QTextEdit::zoomIn(int range = 1)

Agrandit le texte en augmentant la taille de police de base de range points et en recalculant toutes les tailles de police en fonction de cette nouvelle taille. Cela ne modifie pas la taille des images.

Voir également zoomOut().

[slot] void QTextEdit::zoomOut(int range = 1)

Réduit l'échelle du texte en diminuant la taille de police de base de range points et en recalculant toutes les tailles de police en fonction de cette nouvelle taille. Cela ne modifie pas la taille des images.

Voir également zoomIn().