QRadioButton 类
QRadioButton 小部件提供了一个带有文本标签的单选按钮。 更多...
| 头文件 | #include <QRadioButton> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake | QT += widgets |
| 继承 | QAbstractButton |
公共函数
| QRadioButton(QWidget *parent = nullptr) | |
| QRadioButton(const QString &text, QWidget *parent = nullptr) | |
| virtual | ~QRadioButton() |
重实现公共函数
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
保护函数
| virtual void | initStyleOption(QStyleOptionButton *option) const |
重实现保护函数
| virtual bool | event(QEvent *e) override |
| virtual bool | hitButton(const QPoint &pos) const override |
| virtual void | mouseMoveEvent(QMouseEvent *e) override |
| virtual void | paintEvent(QPaintEvent *) override |
详细说明
QRadioButton 是一种可选按钮，可以打开（选中）或关闭（未选中）。单选按钮通常向用户呈现一个“众多之一”的选择。在单选按钮组中，每次只能选中一个单选按钮；如果用户选择了另一个按钮，则之前选中的按钮会关闭。
单选按钮默认为 autoExclusive。如果启用了自动唯一，同一父小部件的单选按钮表现得像它们属于同一个独占按钮组。如果您需要为属于同一父小部件的单选按钮创建多个独占按钮组，请将它们放入一个 QButtonGroup。
每次按钮开启或关闭时，都会发出 toggled() 信号。将信号连接到该信号，以便每次按钮状态改变时触发一个动作。使用 isChecked() 来检查是否选择了特定按钮。
就像QPushButton一样，单选按钮显示文本，可选一个小的图标。图标通过setIcon()设置。文本可以通过构造函数或通过setText()来设置。可以在文本中通过在首选字符前加一个连字符（&）来指定一个快捷键。例如
QRadioButton *button = new QRadioButton("Search from the &cursor", this);
在这个例子中，快捷键是Alt+c。请参阅QShortcut文档以获取详细信息。要显示实际的大于号，请使用'&&'。
重要的继承成员：text()，setText()，setDown()，isDown()，autoRepeat()，group()，setAutoRepeat()，toggle()，pressed()，released()，clicked()，以及toggled()。
参见QPushButton，QToolButton，以及QCheckBox。
成员函数文档
[显式] QRadioButton::QRadioButton(QWidget *parent = nullptr)
使用给定的parent构造单选按钮，但没有任何文本或图标。
parent 参数传递给 QAbstractButton 构造函数。
[显式] QRadioButton::QRadioButton(const QString &text, QWidget *parent = nullptr)
使用给定的parent和text字符串构造单选按钮。
parent 参数传递给 QAbstractButton 构造函数。
[虚拟非抛出异常] QRadioButton::~QRadioButton()
析构函数。
[覆盖虚保护] bool QRadioButton::event(QEvent *e)
重新实现了：QAbstractButton::event(QEvent *e)。
[覆盖虚保护] bool QRadioButton::hitButton(const QPoint &pos) const
重新实现了：QAbstractButton::hitButton(const QPoint &pos) const。
[虚拟保护] void QRadioButton::initStyleOption(QStyleOptionButton *option) const
使用此QRadioButton的值初始化option。此方法对于子类有用途，当它们需要一个QStyleOptionButton，但又不想自己填写全部信息。
[覆盖虚] QSize QRadioButton::minimumSizeHint() const
重实现了属性：?QWidget::minimumSizeHint.
[覆盖 虚拟 受保护的] void QRadioButton::mouseMoveEvent(QMouseEvent *e)
重实现：?QAbstractButton::mouseMoveEvent(QMouseEvent *e).
[覆盖 虚拟 受保护的] void QRadioButton::paintEvent(QPaintEvent *)
重实现：?QAbstractButton::paintEvent(QPaintEvent *e).
[覆盖 虚拟] QSize QRadioButton::sizeHint() const
重实现了属性：?QWidget::sizeHint.
© 2024 Qt公司。本文档中包含的文档贡献属于其各自所有者的版权。本提供的文档是根据自由软件基金会发布的?GNU自由文档许可证版本1.3的条款授予的。Qt及其标志是芬兰以及/或其他地区的Qt公司的商标。所有其他商标均为其各自所有者的财产。
