QLineEdit Class

Documentation des fonctions membres

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

Crée un champ de saisie de texte vide.

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

L'argument ` parent ` est transmis au constructeur ` QWidget `.

Voir également setText() et setMaxLength().

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

Crée un champ de saisie contenant le texte « contents » en tant qu'élément enfant de parent.

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

Voir également text() et setMaxLength().

[virtual noexcept] QLineEdit::~QLineEdit()

Supprime le champ de saisie.

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

Ajoute l'action à la liste des actions disponibles sur position.

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

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

void QLineEdit::backspace()

Si aucun texte n'est sélectionné, cette commande supprime le caractère situé à gauche du curseur et déplace celui-ci d'une position vers la gauche. Si un texte est sélectionné, le curseur est déplacé au début du texte sélectionné, puis celui-ci est supprimé.

Voir aussi del().

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

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

[slot] void QLineEdit::clear()

Efface le contenu du champ de saisie.

Voir également setText() et insert().

QCompleter *QLineEdit::completer() const

Renvoie l'QCompleter e actuelle qui fournit les suggestions de saisie.

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 souhaitez pas que la zone de saisie dispose d’un menu contextuel, vous pouvez définir son paramètre ` contextMenuPolicy ` sur ` 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 ` permet d'obtenir la position du curseur de la souris au moment où l'événement a été généré.

Voir également setContextMenuPolicy().

[slot] void QLineEdit::copy() const

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

Voir également cut() et paste().

QMenu *QLineEdit::createStandardContextMenu()

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. Il est appelé depuis le 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 de steps caractères vers l'arrière. Si mark est vrai, chaque caractère survolé est ajouté à la sélection. Si mark est faux, la sélection est effacée.

Voir aussi cursorForward().

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

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

Voir aussi cursorBackward().

int QLineEdit::cursorPositionAt(const QPoint &pos)

Renvoie 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 indiquée par oldPos, et la nouvelle position par newPos.

Voir également setCursorPosition() et cursorPosition().

[protected] QRect QLineEdit::cursorRect() const

Renvoie un rectangle qui englobe le curseur de la zone de saisie.

void QLineEdit::cursorWordBackward(bool mark)

Déplace le curseur d'un mot vers l'arrière. Si la variable « mark » est définie sur « true », 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 un, et si echoMode() renvoie Normal.

Si le validateur actuel interdit la suppression du texte sélectionné, la fonction cut() effectuera une copie sans suppression.

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

void QLineEdit::del()

Si aucun texte n'est sélectionné, supprime le caractère situé à droite du curseur. Si du texte est sélectionné, le curseur se place au début du texte sélectionné, puis celui-ci est supprimé.

Voir aussi backspace().

void QLineEdit::deselect()

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

Voir également 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 l'on appuie sur la touche Retour ou Entrée, ou si le champ de saisie 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)

Place le curseur de texte à la fin de la ligne, s'il ne s'y trouve pas déjà. Si la variable « mark » est définie à « true », le texte est sélectionné jusqu'à la dernière position. Dans le cas contraire, tout texte sélectionné est désélectionné lorsque 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)

Place le curseur de texte au début de la ligne, s'il ne s'y trouve pas déjà. Si la variable « mark » est définie sur « true », le texte est sélectionné jusqu'à la première position. Sinon, tout texte sélectionné est désélectionné lorsque le curseur est déplacé.

Voir aussi end().

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

Initialisez ` option ` avec les valeurs fournies à l'adresse suivante : QLineEdit. Cette méthode est utile pour les sous-classes qui ont besoin d'un ` QStyleOptionFrame`, mais ne souhaitent pas renseigner elles-mêmes toutes les informations.

Voir également 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` (requête `Qt::InputMethodQuery`) 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 entraîne le retour de la valeur « Invalid » par l'appel validate() du validateur. Un autre cas de figure se présente lorsque l'utilisateur tente de saisir plus de caractères que la longueur maximale autorisée dans le champ de saisie.

void QLineEdit::insert(const QString &newText)

Supprime tout texte sélectionné, insère newText et valide le résultat. Si celui-ci est valide, la fonction attribue le nouveau texte comme nouveau contenu du champ de saisie.

Voir également ` setText()` et ` clear()`.

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

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

Convertit l'event de la touche enfoncée en une action de champ de saisie.

made valid Si la touche Retour ou Entrée est utilisée et que le texte actuel est valide (ou peut être validé par le validateur), le signal returnPressed() est émis.

Voir également 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 pour la propriété : QWidget::minimumSizeHint.

Renvoie la taille minimale de la zone de saisie.

La largeur renvoyée est généralement suffisante pour afficher 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 la zone de saisie ne soit pas en état d'read-only.

Si le résultat final n'est pas valide selon la valeur actuelle de ` validator`, aucune action n'est effectuée.

Voir également copy() et cut().

[slot] void QLineEdit::redo()

Répète la dernière opération si la valeur de « redo » est « available ».

[signal] void QLineEdit::returnPressed()

Ce signal est émis lorsque l'on appuie sur la touche Retour ou Entrée.

[slot] void QLineEdit::selectAll()

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

Voir également setSelection() et deselect().

[signal] void QLineEdit::selectionChanged()

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

Voir également hasSelectedText() et selectedText().

int QLineEdit::selectionEnd() const

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

Voir également selectedText(), selectionStart() et selectionLength().

int QLineEdit::selectionLength() const

Renvoie la longueur de la sélection.

Voir également selectedText(), selectionStart() et selectionEnd().

int QLineEdit::selectionStart() const

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

Voir également selectedText(), selectionEnd() et selectionLength().

void QLineEdit::setCompleter(QCompleter *c)

Configure ce champ de saisie pour qu'il propose des suggestions de saisie automatique provenant du service « completer », c. Le mode de saisie automatique est défini à l'aide de la fonction 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 le QSortFilterProxyModel pour vous assurer que le modèle de QCompleter ne contient que des entrées valides.

Pour supprimer le module de complétion et désactiver la complétion automatique, transmettez un nullptr.

Voir également completer() et QCompleter.

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

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

Voir également deselect(), selectAll() et selectedText().

void QLineEdit::setTextMargins(const QMargins &margins)

Définit l'margins e autour du texte contenu dans le 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 aux tailles suivantes : left, top, right et bottom.

Voir également textMargins().

void QLineEdit::setValidator(const QValidator *v)

Définit le validateur des valeurs du champ de saisie en ligne sur « v ».

Les signaux « returnPressed() » et « editingFinished() » de la zone de saisie ne seront émis que si v valide le contenu de la zone de saisie comme Acceptable. L’utilisateur peut modifier le contenu pour lui attribuer n’importe quelle valeur Intermediate pendant la saisie, mais il ne pourra pas modifier le texte pour lui attribuer une valeur que v valide comme Invalid.

Cela vous permet de restreindre le texte qui sera enregistré une fois la modification terminée, tout en laissant aux utilisateurs suffisamment de liberté pour modifier le texte d’un état valide à un autre.

Pour supprimer le validateur de saisie actuel, transmettez nullptr. Le paramètre par défaut consiste à ne pas utiliser de validateur de saisie (toute saisie est acceptée jusqu’à ce que maxLength()) soit appelé.

Voir également validator(), hasAcceptableInput(), QIntValidator, QDoubleValidator et QRegularExpressionValidator.

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

Réimplémente une fonction d'accès pour 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 environ 15 à 20 caractères.

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

Ce signal est émis chaque fois que le texte change. L'argument ` text ` correspond au nouveau texte.

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

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

Ce signal est émis chaque fois que le texte est modifié. L'argument text correspond au nouveau texte.

Contrairement à la fonction textChanged(), ce signal n'est pas émis lorsque le texte est modifié par programmation, par exemple en appelant la fonction 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 la fonction « undo » est définie sur « available ». Désélectionne toute sélection en cours et définit le point de départ de la sélection à la position actuelle du curseur.

const QValidator *QLineEdit::validator() const

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

Voir aussi setValidator().