内容

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

QPushButton 类

QPushButton 小部件提供命令按钮。 更多...

头：	#include <QPushButton>
qmake:	QT += widgets
继承：	QAbstractButton
继承者：	QCommandLinkButton

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

特性

• autoDefault : bool
• default : bool
• flat : bool

• 11 特性继承自 QAbstractButton
• 59 特性继承自 QWidget
• 1 特性继承自 QObject

公共函数

	QPushButton (QWidget * parent = Q_NULLPTR)
	QPushButton (const QString & text , QWidget * parent = Q_NULLPTR)
	QPushButton (const QIcon & icon , const QString & text , QWidget * parent = Q_NULLPTR)
	~QPushButton ()
bool	autoDefault () const
bool	isDefault () const
bool	isFlat () const
QMenu *	menu () const
void	setAutoDefault ( bool )
void	setDefault ( bool )
void	setFlat ( bool )
void	setMenu (QMenu * menu )

重实现公共函数

virtual QSize	minimumSizeHint () const
virtual QSize	sizeHint () const

• 21 公共函数继承自 QAbstractButton
• 214 公共函数继承自 QWidget
• 32 公共函数继承自 QObject
• 14 公共函数继承自 QPaintDevice

公共槽

void	showMenu ()

• 5 公共槽继承自 QAbstractButton
• 19 公共槽继承自 QWidget
• 1 公共槽继承自 QObject

保护函数

void	initStyleOption (QStyleOptionButton * option ) const

重实现保护函数

virtual bool	event (QEvent * e )
virtual void	focusInEvent (QFocusEvent * e )
virtual void	focusOutEvent (QFocusEvent * e )
virtual void	keyPressEvent (QKeyEvent * e )
virtual void	paintEvent ( QPaintEvent * )

• 14 保护函数继承自 QAbstractButton
• 35 保护函数继承自 QWidget
• 9 保护函数继承自 QObject
• 1 保护函数继承自 QPaintDevice

额外继承成员

• 4 信号继承自 QAbstractButton
• 3 信号继承自 QWidget
• 2 信号继承自 QObject
• 5 静态公共成员继承自 QWidget
• 11 静态公共成员继承自 QObject
• 1 保护槽继承自 QWidget

详细描述

QPushButton 小部件提供命令按钮。

[Missing image windows-pushbutton.jpg]

按钮或命令按钮或许是任何图形用户界面中最常用的 Widget。按下 (点击) 按钮以命令计算机履行某些动作或回答问题。典型按钮有 OK、Apply、Cancel、Close、Yes、No 及 Help。

命令按钮为矩形且通常显示描述其动作的文本标签。可以通过在文本首选字符前面加上 & 和号来指定快捷键。例如：

QPushButton *button = new QPushButton("&Download", this);
					

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

按钮显示正文标签和可选小图标。这些可以使用构造函数设置和以后更改使用 setText () 和 setIcon ()。若按钮被禁用，将根据 GUI 风格操纵文本和图标的外观，以使按钮外观成为被禁用。

按钮发射信号 clicked () 当通过鼠标、空格键或键盘快捷方式激活它时。连接到此信号以履行按钮的动作。按钮还提供不太常用信号，例如 pressed () 和 released ().

默认情况下，对话框中的命令按钮是自动默认按钮 (即：它们会自动变为默认按钮当收到键盘输入聚焦时)。默认按钮是被激活的按钮当用户在对话框中按 Enter 或 Return 键时。可以改变这采用 setAutoDefault ()。注意，自动默认按钮会预留一点额外空间，这是绘制默认按钮指示器所必需的。若不希望此空间围绕在按钮周围，调用 setAutoDefault (false).

由于如此重要，过去十年间按钮 Widget 已发展适应许多变化。微软风格指南现在展示约 10 种不同 Windows 按钮状态，文本还隐含一打以上状态当考虑所有特征组合时。

最重要的模式 (或状态)：

• 可用或不可用 (变灰，被禁用)。
• 标准按钮、触发按钮或菜单按钮。
• 开启或关闭 (仅用于触发按钮)。
• 默认或正常。通常可以使用 Enter 或 Return 键点击对话框中的默认按钮。
• 是否自动重复。
• 是否被按下。

作为一般规则，使用按钮当用户点击应用程序 (或对话框窗口) 履行动作时 (如：应用、取消、关闭和帮助) and 当 Widget 被假定拥有带文本标签的宽矩形形状时。通常，更改窗口状态而不是履行动作的较小方形按钮 (如：右上角按钮在 QFileDialog ) 不是命令按钮，而是工具按钮。Qt 提供特殊类 ( QToolButton ) 为这些按钮。

若需要触发行为 (见 setCheckable ()) 或像滚动条中箭头当被按下时自动重复激活信号的按钮 (见 setAutoRepeat ())，命令按钮可能不是您想要的。如有疑问，使用工具按钮。

注意： 在 macOS，当按钮宽度小于 50 (或高度小于 30) 时，按钮角由圆形变为方形。使用 setMinimumSize () 函数能阻止此行为。

命令按钮的变体是菜单按钮。它们仅仅提供一个命令而是多个命令，由于点击它们时会弹出选项菜单。使用方法 setMenu () 关联弹出菜单与按钮。

其它种类的按钮：选项按钮 (见 QRadioButton ) 和复选框 (见 QCheckBox ).

在 Qt 中， QAbstractButton 基类提供大多数模式和其它 API，而 QPushButton 提供 GUI 逻辑。见 QAbstractButton 了解有关 API 的更多信息。

另请参阅 QToolButton , QRadioButton , QCheckBox ，和 GUI 设计手册：按钮 .

特性文档编制

autoDefault : bool

此特性保持按钮是否为自动默认按钮

若此特性被设为 true，则按钮是自动默认按钮。

In some GUI styles a default button is drawn with an extra frame around it, up to 3 pixels or more. Qt automatically keeps this space free around auto-default buttons, i.e., auto-default buttons may have a slightly larger size hint.

This property's default is true for buttons that have a QDialog parent; otherwise it defaults to false.

见 default property for details of how default and auto-default interact.

访问函数：

bool	autoDefault () const
void	setAutoDefault ( bool )

default : bool

此特性保持按钮是否为默认按钮

Default and autodefault buttons decide what happens when the user presses enter in a dialog.

A button with this property set to true (i.e., the dialog's default button,) will automatically be pressed when the user presses enter, with one exception: if an autoDefault button currently has focus, the autoDefault button is pressed. When the dialog has autoDefault buttons but no default button, pressing enter will press either the autoDefault button that currently has focus, or if no button has focus, the next autoDefault button in the focus chain.

In a dialog, only one push button at a time can be the default button. This button is then displayed with an additional frame (depending on the GUI style).

The default button behavior is provided only in dialogs. Buttons can always be clicked from the keyboard by pressing Spacebar when the button has focus.

If the default property is set to false on the current default button while the dialog is visible, a new default will automatically be assigned the next time a push button in the dialog receives focus.

此特性默认为 false。

访问函数：

bool	isDefault () const
void	setDefault ( bool )

flat : bool

此特性保持按钮边框是否是凸起的

This property's default is false. If this property is set, most styles will not paint the button background unless the button is being pressed. setAutoFillBackground () can be used to ensure that the background is filled using the QPalette::Button brush.

访问函数：

bool	isFlat () const
void	setFlat ( bool )

成员函数文档编制

QPushButton:: QPushButton ( QWidget * parent = Q_NULLPTR)

构造按钮没有文本和 parent .

QPushButton:: QPushButton (const QString & text , QWidget * parent = Q_NULLPTR)

构造按钮采用父级 parent 和文本 text .

QPushButton:: QPushButton (const QIcon & icon , const QString & text , QWidget * parent = Q_NULLPTR)

构造按钮采用 icon 和 text ，和 parent .

注意：也可以传递 QPixmap 对象作为图标 (感谢由 C++ 提供的隐式类型转换)。

QPushButton:: ~QPushButton ()

销毁按钮。

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

重实现自 QObject::event ().

[virtual protected] void QPushButton:: focusInEvent ( QFocusEvent * e )

重实现自 QWidget::focusInEvent ().

[virtual protected] void QPushButton:: focusOutEvent ( QFocusEvent * e )

重实现自 QWidget::focusOutEvent ().

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

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

另请参阅 QStyleOption::initFrom ().

[virtual protected] void QPushButton:: keyPressEvent ( QKeyEvent * e )

重实现自 QWidget::keyPressEvent ().

QMenu *QPushButton:: menu () const

返回按钮关联的弹出菜单，或 0 若未设置弹出菜单。

另请参阅 setMenu ().

[virtual] QSize QPushButton:: minimumSizeHint () const

重实现自 QWidget::minimumSizeHint ().

[virtual protected] void QPushButton:: paintEvent ( QPaintEvent * )

重实现自 QWidget::paintEvent ().

void QPushButton:: setMenu ( QMenu * menu )

关联弹出菜单 menu 与此按钮。这把按钮变成菜单按钮，在某些风格中按钮文本右侧会产生小三角形。

菜单的所有权 not 被传输给按钮。

展示带弹出菜单的按钮在 Fusion 小部件风格 .

另请参阅 menu ().

[slot] void QPushButton:: showMenu ()

展示 (弹出) 关联的弹出菜单。若没有这种菜单，此函数什么都不做。此函数直到用户关闭弹出菜单后才返回。

[virtual] QSize QPushButton:: sizeHint () const

重实现自 QWidget::sizeHint ().