QLabel Class

Documentation sur les fonctions membres

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

Construit une étiquette vide.

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

Voir aussi setAlignment(), setFrameStyle() et setIndent().

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

Construit une étiquette qui affiche le texte text.

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

Voir aussi setText(), setAlignment(), setFrameStyle() et setIndent().

[virtual noexcept] QLabel::~QLabel()

Détruit l'étiquette.

QWidget *QLabel::buddy() const

Renvoie le compagnon de ce label, ou nullptr si aucun compagnon n'est actuellement défini.

Voir aussi setBuddy().

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

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

[slot] void QLabel::clear()

Efface tout le contenu de l'é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 se réfère l'ancre est transmise dans link.

Voir aussi linkHovered().

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

Ce signal est émis lorsque l'utilisateur survole un lien. L'URL référencée par l'ancre est transmise dans link.

Voir aussi linkActivated().

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

Réimplémente une fonction d'accès à 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 sur le film de l'étiquette, ou nullptr si aucun film n'a été défini.

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 riche de cette étiquette.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi setResourceProvider().

int QLabel::selectionStart() const

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

Note : Le jeu de textInteractionFlags sur l'étiquette doit inclure TextSelectableByMouse ou TextSelectableByKeyboard.

Voir aussi selectedText().

void QLabel::setBuddy(QWidget *buddy)

Définit le compagnon de cette étiquette à buddy.

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

Le mécanisme de jumelage n'est disponible que pour les QLabels qui contiennent du texte dont un caractère est préfixé par une esperluette, "&". Ce caractère est défini comme la touche de raccourci. Voir la documentation de QKeySequence::mnemonic() pour plus de détails (pour afficher une esperluette réelle, utilisez '&&').

Dans une boîte de dialogue, vous pouvez créer deux widgets de saisie de données et une étiquette pour chacun d'entre eux, et 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 au champ Nom lorsque l'utilisateur appuie sur Alt+N, et au champ Téléphone lorsque l'utilisateur appuie sur Alt+P.

Pour annuler un copain précédemment défini, appelez cette fonction avec buddy à nullptr.

Voir aussi buddy(), setText(), QShortcut, et setAlignment().

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

Définit le contenu de l'étiquette à movie. Tout contenu antérieur est effacé. L'étiquette n'est PAS propriétaire du film.

Le raccourci copain, s'il existe, est désactivé.

Voir également movie() et setBuddy().

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

Définit le contenu de l'étiquette en texte clair contenant la représentation textuelle de l'entier num. Tout contenu précédent est effacé. Ne fait rien si la représentation sous forme de chaîne de l'entier est la même que le contenu actuel de l'étiquette.

Le raccourci copain, s'il y en a un, 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 aussi setText(), QString::setNum(), et setBuddy().

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

Définit le contenu de l'étiquette en texte clair contenant la représentation textuelle du double num. Tout contenu précédent est effacé. Ne fait rien si la représentation textuelle de double est la même que le contenu actuel de l'étiquette.

Le raccourci copain, s'il y en a un, 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 aussi setText(), QString::setNum(), et setBuddy().

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

Définit le contenu de l'étiquette à picture. Tout contenu antérieur est effacé.

Le raccourci copain, s'il existe, est désactivé.

Voir aussi picture() et setBuddy().

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

Définit l'adresse 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 pour les caractères length.

Remarque : l'ensemble textInteractionFlags de l'étiquette doit inclure TextSelectableByMouse ou TextSelectableByKeyboard.

Voir également selectedText().

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

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