内容

• 公共函数
• 重实现公共函数
• 保护函数
• 重实现保护函数
• 详细描述

QRadioButton 类

QRadioButton 小部件提供带文本标签的单选按钮。 更多...

头：	#include <QRadioButton>
CMake:	find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake:	QT += widgets
继承：	QAbstractButton

• 所有成员列表，包括继承成员

公共函数

	QRadioButton (const QString & text , QWidget * parent = nullptr)
	QRadioButton (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 (自动独占)。若启用自动独占，属于同一父级 Widget 的单选按钮行为，就像它们是同一独占按钮组的一部分。若属于同一父级 Widget 的单选按钮需要多个独占按钮组，把它们放入 QButtonGroup .

每当被切换为开 (或关) 时，按钮发射 toggled () 信号。连接到此信号，若想要在按钮每次改变状态时触发动作。使用 isChecked () 能查看是否选中特定按钮。

就像 QPushButton ，单选按钮显示文本和可选小图标。图标的设置采用 setIcon ()。文本的设置可以在构造函数中或采用 setText ()。通过在文本首选字符之前加 & 号可以指定快捷键。例如：

QRadioButton *button = new QRadioButton("Search from the &cursor", this);
					

在此范例中快捷方式是 Alt+c 。见 QShortcut 文档编制了解细节。要显示实际和号，使用 &&。

重要继承成员： text (), setText (), text (), setDown (), isDown (), autoRepeat (), group (), setAutoRepeat (), toggle (), pressed (), released (), clicked ()，和 toggled ().

另请参阅 QPushButton , QToolButton , QCheckBox , GUI Design Handbook: Radio Button ，和 组框范例 .

成员函数文档编制

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

构造单选按钮采用给定 parent and text 字符串。

parent 自变量被传递给 QAbstractButton 构造函数。

QRadioButton:: QRadioButton ( QWidget * parent = nullptr)

构造单选按钮采用给定 parent ，但没有文本或像素图。

parent 自变量被传递给 QAbstractButton 构造函数。

[虚拟] QRadioButton:: ~QRadioButton ()

析构函数。

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

重实现： QAbstractButton::event (QEvent *e).

[override virtual protected] bool QRadioButton:: hitButton (const QPoint & pos ) const

重实现： QAbstractButton::hitButton (const QPoint &pos) const.

[virtual protected] void QRadioButton:: initStyleOption ( QStyleOptionButton * option ) const

初始化 option 采用值来自此 QRadioButton 。此方法对子类是有用的，当需要 QStyleOptionButton ，但不希望自己填充所有信息。

另请参阅 QStyleOption::initFrom ().

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

重实现访问函数为特性： QWidget::minimumSizeHint .

[override virtual protected] void QRadioButton:: mouseMoveEvent ( QMouseEvent * e )

重实现： QAbstractButton::mouseMoveEvent (QMouseEvent *e).

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

重实现： QAbstractButton::paintEvent (QPaintEvent *e).

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

重实现访问函数为特性： QWidget::sizeHint .