QCommandLinkButton Class

The QCommandLinkButton widget provides a Vista style command link button. More...

Header: #include <QCommandLinkButton>
qmake: QT += widgets
Since: Qt 4.4
Inherits: QPushButton


Public Functions

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)

Reimplemented Protected Functions

virtual bool event(QEvent *e) override
virtual int heightForWidth(int width) const override
virtual QSize minimumSizeHint() const override
virtual void paintEvent(QPaintEvent *) override
virtual QSize sizeHint() const override

Additional Inherited Members

Detailed Description

The QCommandLinkButton widget provides a Vista style command link button.

The command link is a new control that was introduced by Windows Vista. It's intended use is similar to that of a radio button in that it is used to choose between a set of mutually exclusive options. Command link buttons should not be used by themselves but rather as an alternative to radio buttons in Wizards and dialogs and makes pressing the "next" button redundant. The appearance is generally similar to that of a flat pushbutton, but it allows for a descriptive text in addition to the normal button text. By default it will also carry an arrow icon, indicating that pressing the control will open another window or page.

See also QPushButton and QRadioButton.

Property Documentation

description : QString

This property holds a descriptive label to complement the button text

Setting this property will set a descriptive text on the button, complementing the text label. This will usually be displayed in a smaller font than the primary text.

Access functions:

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

flat : bool

This property determines whether the button is displayed as a flat panel or with a border.

By default, this property is set to false.

Access functions:

bool isFlat() const
void setFlat(bool)

See also QPushButton::flat.

Member Function Documentation

QCommandLinkButton::QCommandLinkButton(QWidget *parent = nullptr)

Constructs a command link with no text and a parent.

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

Constructs a command link with the parent parent and the text text.

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

Constructs a command link with a text, a description, and a parent.

[virtual] QCommandLinkButton::~QCommandLinkButton()


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

Reimplemented from QPushButton::event().

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

Reimplemented from QWidget::heightForWidth().

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

Reimplemented from QPushButton::minimumSizeHint().

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

Reimplemented from QPushButton::paintEvent().

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

Reimplemented from QPushButton::sizeHint().

© 2018 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.