QTextEdit Class

Documentation sur les fonctions membres

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

Construit un QTextEdit vide avec le parent parent.

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

Construit un QTextEdit avec le parent parent. L'éditeur de texte affichera le texte text. Le texte est interprété comme du 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'ancre à la position pos, ou une chaîne vide si aucune ancre n'existe à cet endroit.

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

Ajoute un nouveau paragraphe avec text à la fin de l'édition de texte.

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 lorsque, 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 permettre la prise en charge du glisser-déposer pour d'autres types MIME.

bool QTextEdit::canPaste() const

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

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

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

[slot] void QTextEdit::clear()

Supprime tout le texte de l'édition de texte.

Notes : L'historique annuler/refaire est également effacé :

• L'historique annuler/refaire 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 l'éditeur de texte dispose d'un menu contextuel, vous pouvez définir sa valeur 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 dans 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 lorsque du texte est sélectionné ou désélectionné dans l'édition de texte.

Lorsqu'un texte est sélectionné, ce signal est émis lorsque yes vaut true. Si aucun texte n'a été sélectionné ou si le texte sélectionné est désélectionné, ce signal est émis avec yes à false.

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

Voir aussi 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 l'éditeur 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 transmise à 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 sur le texte à éditer avec le bouton droit de la souris. Elle est appelée à partir du 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 sensibles à l'endroit 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 sur le texte à éditer avec le bouton droit de la souris. Elle est appelée à partir du gestionnaire par défaut contextMenuEvent() et prend l'adresse position dans les coordonnées du document où le clic de la souris a eu lieu. Cela permet d'effectuer des actions sensibles à l'endroit 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 d'un nouveau texte.

Voir aussi setCurrentCharFormat().

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

Ce signal est émis si le format de caractère actuel a changé, par exemple en raison d'un changement de la position du curseur.

Le nouveau format est f.

Voir aussi setCurrentCharFormat().

QFont QTextEdit::currentFont() const

Renvoie la police du format actuel.

Voir aussi setCurrentFont(), setFontFamily(), et setFontPointSize().

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

renvoie une adresse QTextCursor à la position pos (dans les coordonnées de la fenêtre).

[signal] void QTextEdit::cursorPositionChanged()

Ce signal est émis lorsque la position du curseur a changé.

QRect QTextEdit::cursorRect() const

renvoie un rectangle (en coordonnées d'affichage) qui inclut le curseur de l'édition de texte.

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

renvoie un rectangle (en coordonnées de la fenêtre) qui inclut le site cursor.

[slot] void QTextEdit::cut()

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

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

Voir aussi 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 l'édition de texte 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())

Trouve la prochaine occurrence de la chaîne de caractères exp, en utilisant la chaîne de caractères options. Renvoie true si exp a été trouvé et change le curseur pour sélectionner la correspondance ; 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'adresse options.

Renvoie true si une correspondance a été trouvée et change le curseur pour sélectionner la 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 aussi setFontFamily(), setCurrentFont(), et setFontPointSize().

bool QTextEdit::fontItalic() const

Renvoie true si la police du format actuel est italique, sinon renvoie false.

Voir aussi setFontItalic().

qreal QTextEdit::fontPointSize() const

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

Voir aussi 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 le poids de la police du format actuel.

Voir aussi 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(Qt::InputMethodQuery query) 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 l'édition de texte à 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 dans le presse-papiers, ou lorsque l'éditeur de texte accepte des données provenant d'une opération de glisser-déposer.

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

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

Slot de commodité qui insère text qui est supposé être de formatage html à la position actuelle du curseur.

Elle est équivalente à :

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

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

Slot de commodité qui insère text à la position actuelle du curseur.

Il est équivalent à

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 données type et name.

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

Voir aussi QTextDocument::loadResource().

void QTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

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

Voir aussi 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 exécutant la commande operation.

Si mode est QTextCursor::KeepAnchor, le curseur sélectionne le texte sur lequel il se déplace. C'est le même effet que l'utilisateur obtient lorsqu'il maintient la touche Shift enfoncée et qu'il déplace le curseur à l'aide des touches du curseur.

Voir aussi QTextCursor::movePosition().

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

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

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de peinture transmis à 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 l'édition de texte à 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 modifier 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 de commodité pour imprimer le document de l'éditeur de texte à l'adresse printer. Cela équivaut à appeler directement la méthode d'impression sur le document, sauf que cette fonction prend également en charge QPrinter::Selection en tant que plage d'impression.

Voir aussi QTextDocument::print().

[slot] void QTextEdit::redo()

Refait la dernière opération.

S'il n'y a pas d'opération à refaire, c'est-à-dire s'il n'y a pas d'étape à refaire dans l'historique undo/redo, rien ne se passe.

Voir également undo().

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

Ce signal est émis lorsque les opérations de rétablissement 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émente : QAbstractScrollArea::scrollContentsBy(int dx, int dy).

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

Fait défiler l'édition de texte de manière à ce que l'ancre correspondant à l'adresse name soit visible ; ne fait rien si l'adresse name est vide, si elle est déjà visible ou si elle n'a pas été trouvée.

[slot] void QTextEdit::selectAll()

Sélectionne tout le texte.

Voir aussi copy(), cut() et textCursor().

[signal] void QTextEdit::selectionChanged()

Ce signal est émis lorsque 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 est centré horizontalement).

Voir aussi alignment().

void QTextEdit::setCurrentCharFormat(const QTextCharFormat &format)

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

Voir aussi currentCharFormat().

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

Définit la police du format actuel à f.

Voir aussi currentFont(), setFontPointSize() et setFontFamily().

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

Cette fonction permet de marquer temporairement certaines régions du document avec une couleur donnée, spécifiée sous selections. Cela peut être utile, par exemple, dans un éditeur de programmation pour marquer toute une ligne de texte avec une couleur de fond donnée afin d'indiquer l'existence 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 à fontFamily.

Voir aussi fontFamily() et setCurrentFont().

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

Si italic est vrai, le format actuel est mis en italique ; sinon, le format actuel est mis en non-italique.

Voir aussi fontItalic().

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

Fixe la taille des points du format actuel à s.

Notez que si s est nul ou négatif, le comportement de cette fonction n'est pas défini.

Voir aussi fontPointSize(), setCurrentFont() et setFontFamily().

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

Si underline est vrai, le format actuel est souligné ; sinon, le format actuel est non souligné.

Voir aussi fontUnderline().

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

Définit le poids de la police du format actuel à la valeur donnée weight, la valeur utilisée étant comprise dans l'intervalle défini par l'énumération QFont::Weight.

Voir aussi fontWeight(), setCurrentFont(), et setFontFamily().

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

Modifie le texte de l'édition de texte en le remplaçant par la chaîne text. Tout texte précédent est supprimé.

Notes :

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

Voir également toPlainText().

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

Définit le format de l'éditeur de texte text. Le texte peut être du texte brut ou du HTML et l'éditeur de texte essaiera de deviner le bon format.

Utilisez directement setHtml() ou setPlainText() pour éviter que l'éditeur de texte ne devine le format.

Voir aussi toPlainText() et toHtml().

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

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

Voir aussi textBackgroundColor().

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

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

Voir aussi textColor().

void QTextEdit::setTextCursor(const QTextCursor &cursor)

Définit la valeur visible de cursor.

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 dans le format actuel.

Voir aussi setTextBackgroundColor().

[signal] void QTextEdit::textChanged()

Ce signal est émis chaque fois que le contenu du document est modifié, par exemple lorsque du texte est inséré ou supprimé, ou lorsque le formatage est appliqué.

QColor QTextEdit::textColor() const

Renvoie la couleur du texte du format actuel.

Voir aussi setTextColor().

QTextCursor QTextEdit::textCursor() const

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

Voir aussi setTextCursor().

QString QTextEdit::toPlainText() const

QString QTextEdit::toPlainText() const

Renvoie le texte de l'édition de texte en texte brut.

Voir également QTextEdit::setPlainText().

[slot] void QTextEdit::undo()

Annule la dernière opération.

S'il n'y a pas d'opération à annuler, c'est-à-dire s'il n'y a pas d'étape d'annulation dans l'historique d'annulation/de rétablissement, rien ne se produit.

Voir également redo().

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

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

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

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

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

Effectue un zoom sur le texte en augmentant la taille de la police de base range points et en recalculant toutes les tailles de police pour qu'elles correspondent à la nouvelle taille. Cette opération ne modifie pas la taille des images.

Voir également zoomOut().

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

Effectue un zoom arrière sur le texte en réduisant la taille de la police de base range points et en recalculant toutes les tailles de police pour qu'elles correspondent à la nouvelle taille. Cette opération ne modifie pas la taille des images.

Voir également zoomIn().