Header：#include < QPushButton >
qmake：QT += widgets
Inherits：QAbstractButton
Inherited By：QCommandLinkButton
Properties
autoDefault : bool
default : bool
flat : bool
Public Functions
QPushButton(const QIcon &icon, const QString &text, QWidget *parent = nullptr)
QPushButton(const QString &text, QWidget *parent = nullptr)
QPushButton(QWidget *parent = nullptr)
virtual ~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)
Reimplemented Public Functions
virtual QSize minimumSizeHint() const override
virtual QSize sizeHint() const override
Public Slots
void showMenu()
Protected Functions
void initStyleOption(QStyleOptionButton *option) const
Reimplemented Protected Functions
virtual bool event(QEvent *e) override
virtual void focusInEvent(QFocusEvent *e) override
virtual void focusOutEvent(QFocusEvent *e) override
virtual void keyPressEvent(QKeyEvent *e) override
virtual void paintEvent(QPaintEvent *) override
Detailed Description
按钮或命令按钮可能是任何图形用户界面中最常用的小部件。按下(点击)按钮命令计算机执行某些操作，或回答一个问题。典型的按钮有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)。
在过去的十年里，按钮部件已经发展到可以容纳许多变化。微软风格指南现在显示了大约十种不同的Windows按钮状态，而文本暗示，如果考虑到所有功能的组合，还有几十种状态。
最重要的模式或状态是:
- 是否可用(灰色显示，禁用)。
- 标准按钮，切换按钮或菜单按钮。
- 打开或关闭(仅用于切换按钮)。
- 默认或正常。对话框中的默认按钮通常可以使用Enter或Return键“单击”。
- 是否自动重复。
- 是否按下。
作为一般规则，当应用程序或对话框窗口在用户单击它时执行操作(例如应用、取消、关闭和帮助)，以及当小部件应该具有带有文本标签的宽矩形形状时，使用按钮。改变窗口状态而不是执行操作的小的、典型的方形按钮(例如QFileDialog右上角的按钮)不是命令按钮，而是工具按钮。Qt为这些按钮提供了一个特殊的类(QToolButton)。
如果您需要切换行为(参见setCheckable())或按钮，当像滚动条中的箭头一样被按下时自动重复激活信号(参见setAutoRepeat())，那么命令按钮可能不是您想要的。当有疑问时，使用工具按钮。
注意:在macOS上，当按钮的宽度小于50或高度小于30时，按钮的角将从圆形变为方形。使用setMinimumSize()函数来防止这种行为。
命令按钮的一种变体是菜单按钮。它们不仅提供一个命令，而且提供多个命令，因为当单击它们时，它们会弹出一个选项菜单。使用setMenu()方法将弹出式菜单与按钮关联起来。
其他类型的按钮是选项按钮(参见QRadioButton)和复选框(参见QCheckBox)。
在Qt中，QAbstractButton基类提供了大多数模式和其他API, QPushButton提供了GUI逻辑。有关API的更多信息，请参见QAbstractButton。
See also QToolButton, QRadioButton, QCheckBox, and GUI Design Handbook: Push Button.
Property Documentation
autoDefault : bool此属性保留按钮是否为自动默认按钮如果此属性设置为true，则按钮是自动默认按钮。在一些GUI样式中，默认按钮周围绘制了一个额外的帧，最多3像素或更多。Qt会自动在自动默认按钮周围保留这个空间，也就是说，自动默认按钮可能有一个稍大的大小提示。对于有QDialog父类的按钮，这个属性的默认值是true;否则默认为false。有关默认和自动默认如何交互的详细信息，请参阅默认属性。
访问函数：bool autoDefault() constvoid setAutoDefault(bool)
default : bool此属性保留按钮是否为默认按钮默认和自动默认按钮决定了当用户在对话框中按下enter键时发生什么。当用户按下回车键时，带有此属性的按钮(即对话框的默认按钮)将自动被按下，但有一个例外:如果autoDefault按钮当前有焦点，则按下autoDefault按钮。当对话框有autoDefault按钮但没有默认按钮时，按enter键将按当前有焦点的autoDefault按钮， 或者如果没有按钮有焦点，则按焦点链中的下一个autoDefault按钮。在对话框中，一次只能有一个按钮是默认按钮。然后，这个按钮会显示一个额外的框架(取决于GUI样式)。默认的按钮行为只在对话框中提供。当按钮有焦点时，可以通过按空格键从键盘上单击按钮。如果当前默认按钮的默认属性设置为false，而对话框是可见的，那么下一次对话框中的按钮接收焦点时，将自动分配一个新的默认值。此属性的默认值为false。
访问函数：bool isDefault() constvoid setDefault(bool)
flat : bool此属性用于确定按钮边框是否凸起此属性的默认值为false。如果设置了此属性，大多数样式将不会绘制按钮背景，除非按钮被按下。setAutoFillBackground()可以用来确保使用QPalette::Button画笔填充背景。
访问函数：bool isFlat() constvoid setFlat(bool)
Member Function Documentation
QPushButton::QPushButton(const QIcon &icon, const QString &text, QWidget *parent = nullptr)构造一个带有图标、文本和父按钮的按钮。注意，您还可以将QPixmap对象作为图标传递(这要归功于c++提供的隐式类型转换)。
QPushButton::QPushButton(const QString &text, QWidget *parent = nullptr)用父类父类和文本类text构造一个按钮。
QPushButton::QPushButton(QWidget *parent = nullptr)构造一个没有文本的按钮和一个父按钮。
[slot] void QPushButton::showMenu()
显示(弹出)相关的弹出菜单。如果没有这样的菜单，这个函数什么也不做。该函数在用户关闭弹出式菜单之前不会返回
[virtual] QPushButton::~QPushButton()销毁PushButton对象。
[override virtual protected] bool QPushButton::event(QEvent *e)Reimplements: QAbstractButton::event(QEvent *e).
[override virtual protected] void QPushButton::focusInEvent(QFocusEvent *e)Reimplements: QAbstractButton::focusInEvent(QFocusEvent *e).
[override virtual protected] void QPushButton::focusOutEvent(QFocusEvent *e)Reimplements: QAbstractButton::focusOutEvent(QFocusEvent *e).
[protected] void QPushButton::initStyleOption(QStyleOptionButton *option) const用这个QPushButton的值初始化选项。当子类需要QStyleOptionButton，但不想自己填充所有信息时，此方法非常有用。
See also QStyleOption::initFrom().
[override virtual protected] void QPushButton::keyPressEvent(QKeyEvent *e)Reimplements: QAbstractButton::keyPressEvent(QKeyEvent *e).
QMenu *QPushButton::menu() const返回按钮关联的弹出式菜单，如果没有设置弹出式菜单则返回nullptr。
See also setMenu().
[override virtual] QSize QPushButton::minimumSizeHint() const
重新实现了property的访问函数: QWidget::minimumSizeHint.
[override virtual protected] void QPushButton::paintEvent(QPaintEvent *)Reimplements: QAbstractButton::paintEvent(QPaintEvent *e).
void QPushButton::setMenu(QMenu *menu)将弹出式菜单菜单与此按钮关联。这将按钮变成一个菜单按钮，在某些样式中，它将在按钮文本的右侧产生一个小三角形。菜单的所有权没有转移到按钮。
See also menu().
一个带有弹出菜单的按钮，以Fusion小部件样式显示。
[override virtual] QSize QPushButton::sizeHint() const
Reimplements an access function for property: QWidget::sizeHint.