QLabel Class

Dokumentation der Mitgliedsfunktionen

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

Erstellt ein leeres Label.

Die Argumente „ parent “ und das Widget-Flag „ f “ werden an den Konstruktor „ QFrame “ übergeben.

Siehe auch „ setAlignment()“, „ setFrameStyle()“ und „ setIndent()“.

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

Erstellt ein Label, das den Text „ text “ anzeigt.

Die Argumente „ parent “ und das Widget-Flag „ f “ werden an den Konstruktor „ QFrame “ übergeben.

Siehe auch „ setText()“, „ setAlignment()“, „ setFrameStyle()“ und „ setIndent()“.

[virtual noexcept] QLabel::~QLabel()

Löscht das Etikett.

QWidget *QLabel::buddy() const

Gibt den „Buddy“ dieses Labels zurück oder nullptr, wenn derzeit kein „Buddy“ festgelegt ist.

Siehe auch ` setBuddy()`.

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

Umsetzt: ` QFrame::changeEvent(QEvent *ev)`.

[slot] void QLabel::clear()

Löscht den Inhalt aller Beschriftungen.

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

Implementiert: ` QWidget::contextMenuEvent` (`QContextMenuEvent *event`).

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

Implementiert: QFrame::event(QEvent *e).

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

Implementiert: ` QWidget::focusInEvent(QFocusEvent *event)`.

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

Implementiert: ` QWidget::focusNextPrevChild` (bool next).

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

Implementiert: ` QWidget::focusOutEvent(QFocusEvent *event)`.

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

Implementiert neu: ` QWidget::heightForWidth(int w) const`.

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

Implementiert: QWidget::keyPressEvent(QKeyEvent *event).

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

Dieses Signal wird ausgelöst, wenn der Benutzer auf einen Link klickt. Die URL, auf die der Anker verweist, wird in „ link “ übergeben.

Siehe auch linkHovered().

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

Dieses Signal wird ausgelöst, wenn der Benutzer mit der Maus über einen Link fährt. Die vom Anker referenzierte URL wird in „ link “ übergeben.

Siehe auch linkActivated().

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

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::minimumSizeHint “ neu.

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

Implementiert: ` QWidget::mouseMoveEvent(QMouseEvent *event)`.

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

Implementiert: ` QWidget::mousePressEvent(QMouseEvent *event)`.

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

Implementiert: ` QWidget::mouseReleaseEvent` (`QMouseEvent *event`).

QMovie *QLabel::movie() const

Gibt einen Zeiger auf den Film des Labels zurück oder „nullptr“, wenn kein Film festgelegt wurde.

Siehe auch „ setMovie()“.

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

Implementiert: ` QFrame::paintEvent` (`QPaintEvent *`).

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

Gibt das Bild des Labels zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch „ setPicture()“.

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

Gibt den Ressourcenanbieter für Rich Text dieser Beschriftung zurück.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch „ setResourceProvider()“.

int QLabel::selectionStart() const

selectionStart() gibt den Index des ersten ausgewählten Zeichens in der Beschriftung zurück oder -1, wenn kein Text ausgewählt ist.

Hinweis: Die für das Label festgelegte Eigenschaft „ textInteractionFlags “ muss entweder „TextSelectableByMouse“ oder „TextSelectableByKeyboard“ enthalten.

Siehe auch ` selectedText()`.

void QLabel::setBuddy(QWidget *buddy)

Legt den „Buddy“ dieses Labels auf „ buddy “ fest.

Wenn der Benutzer die durch dieses Label angegebene Tastenkombination drückt, wird der Tastaturfokus auf das Buddy-Widget des Labels übertragen.

Der Buddy-Mechanismus ist nur für QLabels verfügbar, deren Text ein Zeichen enthält, dem ein Und-Zeichen („&“) vorangestellt ist. Dieses Zeichen wird als Tastenkürzel festgelegt. Weitere Informationen finden Sie in der Dokumentation zu „ QKeySequence::mnemonic()“ (um ein tatsächliches Und-Zeichen anzuzeigen, verwenden Sie „&&“).

In einem Dialogfeld können Sie beispielsweise zwei Eingabefelder und jeweils ein Label erstellen und das Layout so einrichten, dass sich jedes Label direkt links neben seinem Eingabefeld (seinem „Buddy“) befindet, zum Beispiel:

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)

Mit dem obigen Code springt der Fokus auf das Feld „Name“, wenn der Benutzer Alt+N drückt, und auf das Feld „Telefon“, wenn der Benutzer Alt+P drückt.

Um einen zuvor festgelegten „Buddy“ aufzuheben, rufen Sie diese Funktion auf, wobei ` buddy ` auf `nullptr` gesetzt ist.

Siehe auch buddy(), setText(), QShortcut und setAlignment().

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

Setzt den Inhalt der Beschriftung auf „ movie “. Der bisherige Inhalt wird gelöscht. Die Beschriftung übernimmt NICHT die Eigentumsrechte am Film.

Die Buddy-Verknüpfung wird, falls vorhanden, deaktiviert.

Siehe auch „ movie()“ und „ setBuddy()“.

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

Setzt den Inhalt der Beschriftung auf einfachen Text, der die textuelle Darstellung der Ganzzahl num enthält. Der bisherige Inhalt wird gelöscht. Es erfolgt keine Änderung, wenn die Zeichenfolgendarstellung der Ganzzahl mit dem aktuellen Inhalt der Beschriftung übereinstimmt.

Die Buddy-Tastenkombination, falls vorhanden, wird deaktiviert.

// 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); });

Siehe auch „ setText()“, „ QString::setNum()“ und „ setBuddy()“.

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

Setzt den Inhalt der Beschriftung auf einfachen Text, der die textuelle Darstellung des Double-Werts num enthält. Der bisherige Inhalt wird gelöscht. Es erfolgt keine Änderung, wenn die Zeichenfolgendarstellung des Double-Werts mit dem aktuellen Inhalt der Beschriftung übereinstimmt.

Die Buddy-Tastenkombination (sofern vorhanden) wird deaktiviert.

// 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); });

Siehe auch ` setText()`, ` QString::setNum()` und ` setBuddy()`.

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

Setzt den Inhalt des Labels auf „ picture “. Der bisherige Inhalt wird gelöscht.

Die Buddy-Verknüpfung wird, falls vorhanden, deaktiviert.

Siehe auch ` picture()` und ` setBuddy()`.

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

Legt die provider der Ressourcen für den Rich-Text dieses Labels fest.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch ` resourceProvider()`.

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

Wählt Text ab der Position „ start “ und über eine Länge von „ length “ Zeichen aus.

Hinweis: Die im Label festgelegte Eigenschaft „ textInteractionFlags “ muss entweder „TextSelectableByMouse“ oder „TextSelectableByKeyboard“ enthalten.

Siehe auch selectedText().

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

Implementiert neu: ` QFrame::sizeHint()` const.