QLabel Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein leeres Etikett.

Die Argumente parent und widget flag f werden an den QFrame Konstruktor übergeben.

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

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

Konstruiert ein Etikett, das den Text text anzeigt.

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

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

[virtual noexcept] QLabel::~QLabel()

Zerstört das Etikett.

QWidget *QLabel::buddy() const

Gibt den Buddy dieses Etiketts zurück, oder nullptr, wenn kein Buddy gesetzt ist.

Siehe auch setBuddy().

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

Reimplements: QFrame::changeEvent(QEvent *ev).

[slot] void QLabel::clear()

Löscht alle Etiketteninhalte.

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

Reimplements: QWidget::contextMenuEvent(QContextMenuEvent *event).

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

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

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

Reimplements: QWidget::focusInEvent(QFocusEvent *event).

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

Reimplements: QWidget::focusNextPrevChild(bool next).

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

Reimplements: QWidget::focusOutEvent(QFocusEvent *event).

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

Reimplements: QWidget::heightForWidth(int w) const.

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

Reimplements: 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 ausgegeben, wenn der Benutzer den Mauszeiger über einen Link bewegt. Die URL, auf die der Anker verweist, wird in link übergeben.

Siehe auch linkActivated().

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

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::minimumSizeHint.

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

Reimplements: QWidget::mouseMoveEvent(QMouseEvent *event).

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

Reimplements: QWidget::mousePressEvent(QMouseEvent *event).

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

Reimplements: QWidget::mouseReleaseEvent(QMouseEvent *event).

QMovie *QLabel::movie() const

Gibt einen Zeiger auf den Film des Etiketts zurück, oder nullptr, wenn kein Film gesetzt wurde.

Siehe auch setMovie().

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

Reimplements: 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 den Rich Text dieses Labels 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: Der textInteractionFlags -Satz auf dem Label muss entweder TextSelectableByMouse oder TextSelectableByKeyboard enthalten.

Siehe auch selectedText().

void QLabel::setBuddy(QWidget *buddy)

Setzt den Buddy dieses Etiketts auf buddy.

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, die Text enthalten, in dem ein Zeichen mit einem kaufmännischen Und-Zeichen (&) vorangestellt ist. Dieses Zeichen wird als Schnelltaste festgelegt. Weitere Informationen finden Sie in der Dokumentation QKeySequence::mnemonic() (um ein echtes kaufmännisches Und-Zeichen anzuzeigen, verwenden Sie '&&').

In einem Dialog können Sie beispielsweise zwei Dateneingabe-Widgets und jeweils eine Beschriftung erstellen und das Geometrie-Layout so einrichten, dass sich jede Beschriftung direkt links von ihrem Dateneingabe-Widget (ihrem "Kumpel") befindet:

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 gesetzten Buddy wieder zurückzusetzen, rufen Sie diese Funktion mit buddy auf nullptr gesetzt auf.

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

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

Setzt den Inhalt des Etiketts auf movie. Alle vorherigen Inhalte werden gelöscht. Das Etikett übernimmt NICHT das Eigentum an dem Film.

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

Siehe auch movie() und setBuddy().

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

Setzt den Inhalt des Etiketts auf reinen Text, der die textuelle Darstellung der ganzen Zahl num enthält. Jeder vorherige Inhalt wird gelöscht. Führt nichts aus, wenn die String-Darstellung der Ganzzahl mit dem aktuellen Inhalt des Etiketts identisch ist.

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

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

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

Dies ist eine überladene Funktion.

Setzt den Inhalt des Labels auf reinen Text, der die textuelle Darstellung von double num enthält. Jeder vorherige Inhalt wird gelöscht. Führt nichts aus, wenn die String-Darstellung von double mit dem aktuellen Inhalt des Etiketts identisch ist.

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

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

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

Setzt den Inhalt des Etiketts auf picture. Alle vorherigen Inhalte werden gelöscht.

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

Siehe auch picture() und setBuddy().

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

Legt die provider von Ressourcen für Rich Text dieses Etiketts fest.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch resourceProvider().

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

Wählt Text ab Position start und für length Zeichen aus.

Hinweis: Der Satz textInteractionFlags auf dem Etikett muss entweder TextSelectableByMouse oder TextSelectableByKeyboard enthalten.

Siehe auch selectedText().

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

Reimplements: QFrame::sizeHint() const.