QLabel Class

Documentation des fonctions membres

[explicit] QLabel::QLabel(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Crée une étiquette vide.

Les arguments ` parent ` et ` f` (indicateur de widget) sont transmis au constructeur ` QFrame `.

Voir également setAlignment(), setFrameStyle() et setIndent().

[explicit] QLabel::QLabel(const QString &text, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Crée une étiquette affichant le texte « text ».

Les arguments « parent » et « widget flag f » sont transmis au constructeur « QFrame ».

Voir également setText(), setAlignment(), setFrameStyle() et setIndent().

[virtual noexcept] QLabel::~QLabel()

Supprime l'étiquette.

QWidget *QLabel::buddy() const

Renvoie le « buddy » de cette étiquette, ou `nullptr` si aucun « buddy » n'est actuellement défini.

Voir également setBuddy().

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

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

[slot] void QLabel::clear()

Efface le contenu de n'importe quelle étiquette.

[override virtual protected] void QLabel::contextMenuEvent(QContextMenuEvent *ev)

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

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

Réimplémente : QFrame::event(QEvent *e).

[override virtual protected] void QLabel::focusInEvent(QFocusEvent *ev)

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

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

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

[override virtual protected] void QLabel::focusOutEvent(QFocusEvent *ev)

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

[override virtual] int QLabel::heightForWidth(int w) const

Réimplémente : QWidget::heightForWidth(int w) const.

[override virtual protected] void QLabel::keyPressEvent(QKeyEvent *ev)

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

[signal] void QLabel::linkActivated(const QString &link)

Ce signal est émis lorsque l'utilisateur clique sur un lien. L'URL à laquelle renvoie l'ancre est transmise dans ` link`.

Voir également linkHovered().

[signal] void QLabel::linkHovered(const QString &link)

Ce signal est émis lorsque l'utilisateur passe la souris sur un lien. L'URL à laquelle renvoie l'ancre est transmise dans ` link`.

Voir également linkActivated().

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

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

[override virtual protected] void QLabel::mouseMoveEvent(QMouseEvent *ev)

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

[override virtual protected] void QLabel::mousePressEvent(QMouseEvent *ev)

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

[override virtual protected] void QLabel::mouseReleaseEvent(QMouseEvent *ev)

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

QMovie *QLabel::movie() const

Renvoie un pointeur vers l'animation de l'étiquette, ou nullptr si aucune animation n'a été définie.

Voir aussi setMovie().

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

Réimplémente : QFrame::paintEvent(QPaintEvent *).

[since 6.0] QPicture QLabel::picture() const

Renvoie l'image de l'étiquette.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi setPicture().

[since 6.1] QTextDocument::ResourceProvider QLabel::resourceProvider() const

Renvoie le fournisseur de ressources pour le texte enrichi de cette étiquette.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi ` setResourceProvider()`.

int QLabel::selectionStart() const

La fonction selectionStart() renvoie l'index du premier caractère sélectionné dans l'étiquette ou -1 si aucun texte n'est sélectionné.

Remarque : l’ textInteractionFlags, défini sur l’étiquette, doit inclure soit TextSelectableByMouse, soit TextSelectableByKeyboard.

Voir aussi selectedText().

void QLabel::setBuddy(QWidget *buddy)

Définit le widget associé à cette étiquette sur buddy.

Lorsque l'utilisateur appuie sur la touche de raccourci indiquée par cette étiquette, le focus clavier est transféré vers le widget associé à l'étiquette.

Le mécanisme de « buddy » n’est disponible que pour les QLabels contenant du texte dans lequel un caractère est précédé d’un « & » (esperluette). Ce caractère est défini comme touche de raccourci. Consultez la documentation relative à la fonction QKeySequence::mnemonic() pour plus de détails (pour afficher une véritable esperluette, utilisez « && »).

Dans une boîte de dialogue, vous pouvez créer deux widgets de saisie de données et une étiquette pour chacun d’eux, puis configurer la disposition géométrique de manière à ce que chaque étiquette se trouve juste à gauche de son widget de saisie de données (son « compagnon »), par exemple :

QLineEdit *nameEdit  = new QLineEdit(this);
QLabel    *nameLabel = new QLabel("&Name:", this);
nameLabel->setBuddy(nameEdit);
QLineEdit *phoneEdit  = new QLineEdit(this);
QLabel    *phoneLabel = new QLabel("&Phone:", this);
phoneLabel->setBuddy(phoneEdit);
// (layout setup not shown)

Avec le code ci-dessus, le focus passe sur le champ « Nom » lorsque l’utilisateur appuie sur Alt+N, et sur le champ « Téléphone » lorsqu’il appuie sur Alt+P.

Pour désactiver un « buddy » précédemment défini, appelez cette fonction en passant ` buddy ` à `nullptr`.

Voir également buddy(), setText(), QShortcut et setAlignment().

[slot] void QLabel::setMovie(QMovie *movie)

Définit le contenu de l'étiquette sur « movie ». Tout contenu précédent est effacé. L'étiquette ne prend PAS possession du film.

Le raccourci « buddy », s'il existe, est désactivé.

Voir également movie() et setBuddy().

[slot] void QLabel::setNum(int num)

Définit le contenu de l'étiquette sous forme de texte brut contenant la représentation textuelle de l'entier num. Tout contenu précédent est effacé. Cette opération n'a aucun effet si la représentation sous forme de chaîne de caractères de l'entier est identique au contenu actuel de l'étiquette.

Le raccourci « buddy », s'il existe, est désactivé.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        label, qOverload(&QLabel::setNum));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        label, [receiver = label](int num) { receiver->setNum(num); });

Voir également setText(), QString::setNum() et setBuddy().

[slot] void QLabel::setNum(double num)

Définit le contenu de l'étiquette sur du texte brut contenant la représentation textuelle d'un nombre de type double num. Tout contenu précédent est effacé. Ne fait rien si la représentation sous forme de chaîne de ce nombre de type double est identique au contenu actuel de l'étiquette.

Le raccourci « buddy », s'il existe, est désactivé.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        label, qOverload(&QLabel::setNum));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        label, [receiver = label](double num) { receiver->setNum(num); });

Voir également setText(), QString::setNum() et setBuddy().

[slot] void QLabel::setPicture(const QPicture &picture)

Définit le contenu de l'étiquette sur « picture ». Tout contenu précédent est effacé.

Le raccourci « buddy », s'il existe, est désactivé.

Voir également picture() et setBuddy().

[since 6.1] void QLabel::setResourceProvider(const QTextDocument::ResourceProvider &provider)

Définit l'provider des ressources pour le texte enrichi de cette étiquette.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi ` resourceProvider()`.

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

Sélectionne le texte à partir de la position start et sur une longueur de length caractères.

Remarque : la propriété textInteractionFlags définie sur l'étiquette doit inclure soit TextSelectableByMouse, soit TextSelectableByKeyboard.

Voir également selectedText().

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

Réimplémente : ` QFrame::sizeHint()` const.