Auf dieser Seite

QCommandLinkButton Class

Das Widget „QCommandLinkButton“ stellt eine Befehlsschaltfläche im Vista-Stil bereit. Mehr...

Überschrift: #include <QCommandLinkButton>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Erbt: QPushButton

Eigenschaften

Öffentliche Funktionen

QCommandLinkButton(QWidget *parent = nullptr)
QCommandLinkButton(const QString &text, QWidget *parent = nullptr)
QCommandLinkButton(const QString &text, const QString &description, QWidget *parent = nullptr)
virtual ~QCommandLinkButton()
QString description() const
void setDescription(const QString &description)

Neu implementierte öffentliche Funktionen

virtual int heightForWidth(int width) const override
virtual QSize minimumSizeHint() const override
virtual QSize sizeHint() const override

Neu implementierte geschützte Funktionen

virtual bool event(QEvent *e) override
virtual void paintEvent(QPaintEvent *) override

Ausführliche Beschreibung

Der Befehlslink ist ein neues Steuerelement, das mit Windows Vista eingeführt wurde. Seine Verwendungszweck ähnelt dem eines Optionsfelds, da er dazu dient, zwischen einer Reihe sich gegenseitig ausschließender Optionen zu wählen. Befehlslink-Schaltflächen sollten nicht isoliert verwendet werden, sondern vielmehr als Alternative zu Optionsfeldern in Assistenten und Dialogfeldern, wodurch das Klicken auf die Schaltfläche „Weiter“ überflüssig wird. Das Erscheinungsbild ähnelt im Allgemeinen dem einer flachen Schaltfläche, ermöglicht jedoch zusätzlich zum normalen Schaltflächentext die Angabe eines beschreibenden Textes. Standardmäßig wird außerdem ein Pfeilsymbol angezeigt, das darauf hinweist, dass durch Betätigen des Steuerelements ein anderes Fenster oder eine andere Seite geöffnet wird.

Siehe auch QPushButton und QRadioButton.

Dokumentation zu den Eigenschaften

description : QString

Diese Eigenschaft enthält eine beschreibende Beschriftung, die den Text der Schaltfläche ergänzt

Durch das Festlegen dieser Eigenschaft wird ein beschreibender Text auf der Schaltfläche angezeigt, der die Textbeschriftung ergänzt. Dieser wird in der Regel in einer kleineren Schriftart als der Haupttext dargestellt.

Zugriffsfunktionen:

QString description() const
void setDescription(const QString &description)

flat : bool

Diese Eigenschaft legt fest, ob die Schaltfläche als flache Fläche oder mit einem Rahmen angezeigt wird.

Standardmäßig ist diese Eigenschaft auf „false“ gesetzt.

Zugriffsfunktionen:

bool isFlat() const
void setFlat(bool)

Siehe auch „ QPushButton::flat “.

Dokumentation der Member-Funktionen

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

Erstellt einen Befehls-Link ohne Text und mit der URL parent.

[explicit] QCommandLinkButton::QCommandLinkButton(const QString &text, QWidget *parent = nullptr)

Erstellt einen Befehls-Link mit der übergeordneten URL parent und dem Text text.

[explicit] QCommandLinkButton::QCommandLinkButton(const QString &text, const QString &description, QWidget *parent = nullptr)

Erstellt einen Befehls-Link mit einem text, einem description und einem parent.

[virtual noexcept] QCommandLinkButton::~QCommandLinkButton()

Destruktor.

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

Implementiert neu: QPushButton::event(QEvent *e).

[override virtual] int QCommandLinkButton::heightForWidth(int width) const

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

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

Implementiert neu: ` QPushButton::minimumSizeHint()` const.

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

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

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

Implementiert: ` QPushButton::sizeHint()` const.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.