QPlainTextEdit Class

Documentation sur les fonctions membres

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

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

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

Crée un objet `QPlainTextEdit` dont le parent est ` parent`. La zone d'édition affichera le texte brut ` text`.

[virtual noexcept] QPlainTextEdit::~QPlainTextEdit()

Destructeur.

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

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

[slot] void QPlainTextEdit::appendHtml(const QString &html)

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

appendPlainText()

[slot] void QPlainTextEdit::appendPlainText(const QString &text)

Ajoute un nouveau paragraphe contenant « text » à la fin du texte modifié.

Voir aussi appendHtml().

[protected] QRectF QPlainTextEdit::blockBoundingGeometry(const QTextBlock &block) const

Renvoie le rectangle englobant du texte block en coordonnées de contenu. Translatez le rectangle à l'aide de la fonction contentOffset() pour obtenir les coordonnées visuelles dans la fenêtre d'affichage.

Voir également firstVisibleBlock() et blockBoundingRect().

[protected] QRectF QPlainTextEdit::blockBoundingRect(const QTextBlock &block) const

Renvoie le rectangle englobant du texte block dans les coordonnées propres au bloc.

Voir aussi blockBoundingGeometry().

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

Ce signal est émis chaque fois que le nombre de blocs change. Le nouveau nombre de blocs est transmis dans ` newBlockCount`.

[virtual protected] bool QPlainTextEdit::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 le glisser-déposer.

bool QPlainTextEdit::canPaste() const

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

[slot] void QPlainTextEdit::centerCursor()

Fait défiler le document afin de centrer le curseur verticalement.

Voir également ensureCursorVisible() et centerOnScroll.

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

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

[slot] void QPlainTextEdit::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() et setPlainText().

[protected] QPointF QPlainTextEdit::contentOffset() const

Renvoie l'origine du contenu en coordonnées de la fenêtre d'affichage.

L'origine du contenu d'un champ d'édition de texte brut correspond toujours au coin supérieur gauche du premier bloc de texte visible. Le décalage du contenu est différent de (0,0) lorsque le texte a été défilé horizontalement, ou lorsque le premier bloc visible a été partiellement déplacé hors de l'écran, c'est-à-dire que le texte visible ne commence pas par la première ligne du premier bloc visible, ou encore lorsque le premier bloc visible est le tout premier bloc et que l'éditeur affiche une marge.

Voir également firstVisibleBlock(), horizontalScrollBar() et verticalScrollBar().

[override virtual protected] void QPlainTextEdit::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 MyQPlainTextEdit::contextMenuEvent(QContextMenuEvent *event)
{
    QMenu *menu = createStandardContextMenu();
    menu->addAction(tr("My Menu Item"));
    //...
    menu->exec(event->globalPos());
    delete menu;
}

[slot] void QPlainTextEdit::copy()

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

Voir aussi copyAvailable().

[signal] void QPlainTextEdit::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'une sélection de texte est effectuée, ce signal est émis avec la propriété « yes » définie sur « true ». Si aucun texte n'a été sélectionné ou si la sélection est désélectionnée, 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 *QPlainTextEdit::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 *QPlainTextEdit::createStandardContextMenu()

Cette fonction crée le menu contextuel standard qui s'affiche lorsque l'utilisateur clique avec le bouton droit de la souris sur le champ de saisie 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 *QPlainTextEdit::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 l'position, exprimée en coordonnées du document, de l'emplacement 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 QPlainTextEdit::currentCharFormat() const

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

Voir aussi setCurrentCharFormat().

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

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

[signal] void QPlainTextEdit::cursorPositionChanged()

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

QRect QPlainTextEdit::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 QPlainTextEdit::cursorRect(const QTextCursor &cursor) const

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

[slot] void QPlainTextEdit::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().

QTextDocument *QPlainTextEdit::document() const

Renvoie un pointeur vers le document sous-jacent.

Voir aussi setDocument().

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

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

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

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

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

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

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

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

void QPlainTextEdit::ensureCursorVisible()

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

Voir également centerCursor() et centerOnScroll.

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

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

Voir aussi setExtraSelections().

bool QPlainTextEdit::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 correspondante ; sinon, renvoie « false ».

bool QPlainTextEdit::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 celle-ci ; sinon, renvoie false.

[protected] QTextBlock QPlainTextEdit::firstVisibleBlock() const

Renvoie le premier bloc visible.

Voir également blockBoundingRect().

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

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

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

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

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

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

[protected] QAbstractTextDocumentLayout::PaintContext QPlainTextEdit::getPaintContext() const

Renvoie le contexte de dessin de la fonction ` viewport()`, ce qui n'est utile que lors de la réimplémentation de la fonction ` paintEvent()`.

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

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

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

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

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

Cette fonction insère le contenu de l'objet de données MIME, spécifié par ` source`, dans la zone d'é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 à partir du presse-papiers, ou lorsque la zone d'édition de texte accepte des données issues d'une opération de glisser-déposer.

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

Fonction pratique permettant d’insérer « text » à la position actuelle du curseur.

Cela équivaut à

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

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

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

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

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

[virtual] QVariant QPlainTextEdit::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 QPlainTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

Intègre les propriétés spécifiées dans ` modifier ` au format de caractère actuel en appelant ` 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().

[signal] void QPlainTextEdit::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`, cela signifie que le document a été modifié ; dans le cas contraire, elle est `false`.

Par exemple, appeler la méthode `setModified(false)` sur un document puis y insérer du texte provoque l'émission du signal. Si vous annulez cette opération, ramenant ainsi le document à son état d'origine non modifié, le signal sera à nouveau émis.

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

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

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

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

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

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

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

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

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

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

Si ` mode ` est défini sur ` 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 QPlainTextEdit::paintEvent(QPaintEvent *e)

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

[slot] void QPlainTextEdit::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 QPlainTextEdit peut coller et comment cela est effectué, réimplémentez les fonctions virtuelles canInsertFromMimeData() et insertFromMimeData().

Voir également cut() et copy().

void QPlainTextEdit::print(QPagedPaintDevice *printer) const

Fonction pratique permettant d'imprimer le document de l'objet TextEdit sur 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 QPlainTextEdit::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 refonte dans l'historique des annulations/reprises, rien ne se passe.

Voir également undo().

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

Ce signal est émis dès que les opérations de réexécution deviennent disponibles (la valeur de `available ` est vraie) ou indisponibles (la valeur de `available ` est fausse).

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

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

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

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

[slot] void QPlainTextEdit::selectAll()

Sélectionne tout le texte.

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

[signal] void QPlainTextEdit::selectionChanged()

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

Voir également copyAvailable().

void QPlainTextEdit::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().

void QPlainTextEdit::setDocument(QTextDocument *document)

Définit document comme nouveau document de l'éditeur de texte.

L'QObject parent du document fourni reste le propriétaire de l'objet. Si le document actuel est un enfant de l'éditeur de texte, il est alors supprimé.

Le document doit disposer d’une mise en page héritant de ` QPlainTextDocumentLayout ` (voir ` QTextDocument::setDocumentLayout()`).

Voir également document().

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

Cette fonction permet de marquer temporairement certaines zones du document avec une couleur donnée, spécifiée par ` 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 QPlainTextEdit::setPlainText(const QString &text)

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

text est interprété comme du texte brut.

Remarques :

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

Voir également toPlainText().

void QPlainTextEdit::setTextCursor(const QTextCursor &cursor)

Définit l'cursor visible.

Voir également textCursor().

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

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

[signal] void QPlainTextEdit::textChanged()

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

QTextCursor QPlainTextEdit::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 ` QPlainTextEdit` ; utilisez ` setTextCursor()` pour mettre à jour le curseur visible.

Voir également setTextCursor().

QString QPlainTextEdit::toPlainText() const

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

Voir aussi QPlainTextEdit::setPlainText().

[slot] void QPlainTextEdit::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 et des rétablissements, rien ne se passe.

Voir également redo().

[signal] void QPlainTextEdit::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).

[signal] void QPlainTextEdit::updateRequest(const QRect &rect, int dy)

Ce signal est émis lorsque le document texte nécessite une mise à jour de l'rect spécifiée. Si le texte fait l'objet d'un défilement, rect couvre l'intégralité de la zone de la fenêtre d'affichage. Si le texte défile verticalement, dy contient le nombre de pixels sur lesquels la fenêtre d'affichage a défilé.

Ce signal a pour but de prendre en charge des widgets supplémentaires dans les sous-classes d’édition de texte brut qui, par exemple, affichent des numéros de ligne, des points d’arrêt ou d’autres informations complémentaires.

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

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

[slot] void QPlainTextEdit::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 QPlainTextEdit::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 valeur. Cela ne modifie pas la taille des images.

Voir également zoomIn().