QLineEdit Class

Documentation des fonctions membres

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

Construit une ligne d'édition sans texte.

La longueur maximale du texte est fixée à 32767 caractères.

L'argument parent est envoyé au constructeur QWidget.

Voir aussi setText() et setMaxLength().

[explicit] QLineEdit::QLineEdit(const QString &contents, QWidget *parent = nullptr)

Construit un montage de lignes contenant le texte contents en tant qu'enfant de parent.

La position du curseur est fixée à la fin de la ligne et la longueur maximale du texte est de 32767 caractères.

Voir aussi text() et setMaxLength().

[virtual noexcept] QLineEdit::~QLineEdit()

Détruit l'édition de ligne.

void QLineEdit::addAction(QAction *action, QLineEdit::ActionPosition position)

Ajoute le site action à la liste des actions du site position.

QAction *QLineEdit::addAction(const QIcon &icon, QLineEdit::ActionPosition position)

Crée une nouvelle action avec l'adresse icon donnée à l'adresse position.

void QLineEdit::backspace()

Si aucun texte n'est sélectionné, le caractère situé à gauche du curseur de texte est supprimé et le curseur est déplacé d'une position vers la gauche. Si un texte est sélectionné, le curseur est déplacé au début du texte sélectionné et le texte sélectionné est supprimé.

Voir également del().

[override virtual protected] void QLineEdit::changeEvent(QEvent *ev)

Réimplémente : QWidget::changeEvent(QEvent *event).

[slot] void QLineEdit::clear()

Efface le contenu de l'édition de ligne.

Voir aussi setText() et insert().

QCompleter *QLineEdit::completer() const

Renvoie l'adresse QCompleter actuelle qui fournit des compléments.

Voir aussi setCompleter().

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

Réimplémente : QWidget::contextMenuEvent(QContextMenuEvent *event).

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

Si vous ne voulez pas que l'édition de ligne ait un menu contextuel, vous pouvez définir son contextMenuPolicy à Qt::NoContextMenu. Pour personnaliser le menu contextuel, réimplémentez cette fonction. Pour étendre le menu contextuel standard, réimplémentez cette fonction, appelez createStandardContextMenu() et étendez le menu renvoyé.

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

Le paramètre event est utilisé pour obtenir la position du curseur de la souris lorsque l'événement a été généré.

Voir aussi setContextMenuPolicy().

[slot] void QLineEdit::copy() const

Copie le texte sélectionné dans le presse-papiers, s'il y en a un, et si echoMode() est Normal.

Voir également cut() et paste().

QMenu *QLineEdit::createStandardContextMenu()

Crée le menu contextuel standard, qui s'affiche lorsque l'utilisateur clique sur la ligne d'édition avec le bouton droit de la souris. Il est appelé à partir du gestionnaire par défaut contextMenuEvent(). La propriété du menu contextuel est transférée à l'appelant.

void QLineEdit::cursorBackward(bool mark, int steps = 1)

Déplace le curseur vers l'arrière steps caractères. Si mark est vrai, chaque caractère déplacé est ajouté à la sélection. Si mark est faux, la sélection est effacée.

Voir également cursorForward().

void QLineEdit::cursorForward(bool mark, int steps = 1)

Déplace le curseur vers l'avant steps caractères. Si mark est vrai, chaque caractère déplacé est ajouté à la sélection. Si mark est faux, la sélection est effacée.

Voir également cursorBackward().

int QLineEdit::cursorPositionAt(const QPoint &pos)

Retourne la position du curseur sous le point pos.

[signal] void QLineEdit::cursorPositionChanged(int oldPos, int newPos)

Ce signal est émis à chaque fois que le curseur se déplace. La position précédente est donnée par oldPos, et la nouvelle position par newPos.

Voir aussi setCursorPosition() et cursorPosition().

[protected] QRect QLineEdit::cursorRect() const

Renvoie un rectangle qui inclut le curseur d'édition de ligne.

void QLineEdit::cursorWordBackward(bool mark)

Déplace le curseur d'un mot vers l'arrière. Si mark est vrai, le mot est également sélectionné.

Voir aussi cursorWordForward().

void QLineEdit::cursorWordForward(bool mark)

Déplace le curseur d'un mot vers l'avant. Si mark est vrai, le mot est également sélectionné.

Voir aussi cursorWordBackward().

[slot] void QLineEdit::cut()

Copie le texte sélectionné dans le presse-papiers et le supprime, s'il y en a, et si echoMode() est Normal.

Si le validateur actuel n'autorise pas la suppression du texte sélectionné, cut() le copiera sans le supprimer.

Voir également copy(), paste() et setValidator().

void QLineEdit::del()

Si aucun texte n'est sélectionné, le caractère situé à droite du curseur de texte est supprimé. Si un texte est sélectionné, le curseur est déplacé au début du texte sélectionné et le texte sélectionné est supprimé.

Voir également backspace().

void QLineEdit::deselect()

Désélectionne tout texte sélectionné.

Voir aussi setSelection() et selectAll().

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

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

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

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

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

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

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

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

[signal] void QLineEdit::editingFinished()

Ce signal est émis lorsque la touche Return ou Enter est utilisée, ou si l'édition de ligne perd le focus et que son contenu a changé depuis la dernière fois que ce signal a été émis.

void QLineEdit::end(bool mark)

Déplace le curseur de texte à la fin de la ligne, sauf s'il s'y trouve déjà. Si mark est vrai, le texte est sélectionné vers la dernière position. Sinon, tout texte sélectionné est désélectionné si le curseur est déplacé.

Voir aussi home().

[override virtual] bool QLineEdit::event(QEvent *e)

Réimplémente : QWidget::event(QEvent *event).

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

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

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

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

void QLineEdit::home(bool mark)

Déplace le curseur de texte au début de la ligne, sauf s'il s'y trouve déjà. Si mark est vrai, le texte est sélectionné vers la première position. Sinon, tout texte sélectionné est désélectionné si le curseur est déplacé.

Voir aussi end().

[virtual protected] void QLineEdit::initStyleOption(QStyleOptionFrame *option) const

Initialiser option avec les valeurs de QLineEdit. Cette méthode est utile pour les sous-classes qui ont besoin d'un QStyleOptionFrame, mais qui ne veulent pas remplir toutes les informations elles-mêmes.

Voir aussi QStyleOption::initFrom().

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

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

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

Réimplémente : QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

[signal] void QLineEdit::inputRejected()

Ce signal est émis lorsque l'utilisateur utilise une touche qui n'est pas considérée comme une entrée valide. Par exemple, si l'utilisation d'une touche a pour conséquence que l'appel à validate() d'un validateur renvoie Invalid. Un autre cas est celui où l'on essaie d'entrer plus de caractères que la longueur maximale de l'édition de ligne.

void QLineEdit::insert(const QString &newText)

Supprime tout texte sélectionné, insère newText, et valide le résultat. S'il est valide, il définit le nouveau texte comme le nouveau contenu de l'édition de ligne.

Voir également setText() et clear().

[override virtual protected] void QLineEdit::keyPressEvent(QKeyEvent *event)

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

Convertit la pression d'une touche donnée event en une action d'édition de ligne.

Si Return ou Enter est utilisé et que le texte actuel est valide (ou peut être made valid par le validateur), le signal returnPressed() est émis.

Voir aussi Default Key Bindings.

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

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

[override virtual] QSize QLineEdit::minimumSizeHint() const

Réimplémente une fonction d'accès à la propriété : QWidget::minimumSizeHint.

Renvoie une taille minimale pour l'édition de la ligne.

La largeur renvoyée est généralement suffisante pour au moins un caractère.

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

Réimplémente : QWidget::mouseDoubleClickEvent(QMouseEvent *event).

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

Réimplémente : QWidget::mouseMoveEvent(QMouseEvent *event).

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

Réimplémente : QWidget::mousePressEvent(QMouseEvent *event).

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

Réimplémente : QWidget::mouseReleaseEvent(QMouseEvent *event).

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

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

[slot] void QLineEdit::paste()

Insère le texte du presse-papiers à la position du curseur, en supprimant tout texte sélectionné, à condition que l'édition de ligne ne soit pas read-only.

Si le résultat final n'est pas valide pour l'utilisateur actuel validator, rien ne se produit.

Voir également copy() et cut().

[slot] void QLineEdit::redo()

Refait la dernière opération si redo est available.

[signal] void QLineEdit::returnPressed()

Ce signal est émis lorsque la touche Return ou Enter est utilisée.

[slot] void QLineEdit::selectAll()

Sélectionne tout le texte (le met en surbrillance) et déplace le curseur jusqu'à la fin.

Voir également setSelection() et deselect().

[signal] void QLineEdit::selectionChanged()

Ce signal est émis lorsque la sélection change.

Voir aussi hasSelectedText() et selectedText().

int QLineEdit::selectionEnd() const

Renvoie l'index du caractère situé directement après la sélection dans l'édition de ligne (ou -1 si aucun texte n'est sélectionné).

Voir aussi selectedText(), selectionStart() et selectionLength().

int QLineEdit::selectionLength() const

Renvoie la longueur de la sélection.

Voir aussi selectedText(), selectionStart() et selectionEnd().

int QLineEdit::selectionStart() const

Renvoie l'index du premier caractère sélectionné dans l'édition de ligne (ou -1 si aucun texte n'est sélectionné).

Voir aussi selectedText(), selectionEnd() et selectionLength().

void QLineEdit::setCompleter(QCompleter *c)

Configure cet éditeur de ligne pour qu'il fournisse des compléments automatiques à partir du compléteur, c. Le mode de complétion est défini à l'aide de QCompleter::setCompletionMode().

Pour utiliser un QCompleter avec un QValidator ou un QLineEdit::inputMask, vous devez vous assurer que le modèle fourni à QCompleter contient des entrées valides. Vous pouvez utiliser QSortFilterProxyModel pour vous assurer que le modèle de QCompleter ne contient que des entrées valides.

Pour supprimer le compléteur et désactiver l'autocomplétion, passez un nullptr.

Voir également completer() et QCompleter.

void QLineEdit::setSelection(int start, int length)

Sélectionne le texte à partir de la position start et pour les caractères length. Les longueurs négatives sont autorisées.

Voir aussi deselect(), selectAll() et selectedText().

void QLineEdit::setTextMargins(const QMargins &margins)

Définit l'adresse margins autour du texte à l'intérieur du cadre.

Voir aussi textMargins().

void QLineEdit::setTextMargins(int left, int top, int right, int bottom)

Définit les marges autour du texte à l'intérieur du cadre pour qu'elles aient les tailles left, top, right, et bottom.

Voir aussi textMargins().

void QLineEdit::setValidator(const QValidator *v)

Définit le validateur pour les valeurs de line edit à v.

Les signaux returnPressed() et editingFinished() de l'édition de ligne ne seront émis que si v valide le contenu de l'édition de ligne comme étant Acceptable. L'utilisateur peut modifier le contenu à n'importe quelle valeur Intermediate pendant l'édition, mais il ne pourra pas modifier le texte à une valeur que v valide comme Invalid.

Cela vous permet de limiter le texte qui sera stocké lorsque l'édition est terminée, tout en laissant aux utilisateurs suffisamment de liberté pour modifier le texte d'un état valide à un autre.

Pour supprimer le validateur d'entrée actuel, passez nullptr. La configuration initiale est de ne pas avoir de validateur d'entrée (toute entrée est acceptée jusqu'à maxLength()).

Voir aussi validator(), hasAcceptableInput(), QIntValidator, QDoubleValidator, et QRegularExpressionValidator.

[override virtual] QSize QLineEdit::sizeHint() const

Réimplémente une fonction d'accès à la propriété : QWidget::sizeHint.

Renvoie une taille recommandée pour le widget.

La largeur renvoyée, en pixels, est généralement suffisante pour 15 à 20 caractères.

[signal] void QLineEdit::textChanged(const QString &text)

Ce signal est émis lorsque le texte change. L'argument text est le nouveau texte.

Contrairement à textEdited(), ce signal est également émis lorsque le texte est modifié par programme, par exemple en appelant setText().

[signal] void QLineEdit::textEdited(const QString &text)

Ce signal est émis lorsque le texte est modifié. L'argument text est le nouveau texte.

Contrairement à textChanged(), ce signal n'est pas émis lorsque le texte est modifié par programme, par exemple en appelant setText().

QMargins QLineEdit::textMargins() const

Renvoie les marges de texte du widget.

Voir aussi setTextMargins().

[override virtual] void QLineEdit::timerEvent(QTimerEvent *e)

Réimplémente : QObject::timerEvent(QTimerEvent *event).

[slot] void QLineEdit::undo()

Annule la dernière opération si l'option d'annulation se trouve à l'adresse available. Désélectionne toute sélection en cours et met à jour le début de la sélection à la position actuelle du curseur.

const QValidator *QLineEdit::validator() const

Renvoie un pointeur sur le validateur d'entrée actuel, ou nullptr si aucun validateur n'a été défini.

Voir aussi setValidator().