文章目录
- 一、QPushButton介绍
- 二、Properties(属性)
- 三、Public Functions(公共函数)
- 1.构造函数--构造按钮对象
- 2.autoDefault与setAutoDefault函数--获取/设置按钮的自动默认状态
- 3.isDefault与setDefault函数-- 获取/设置按钮的默认状态
- 4.isFlat与setFlat函数--获取/设置按钮边框是否凸起
- 5.menu与setMenu函数--获取/设置与按钮关联的弹出菜单(菜单按钮)
- 四、Reimplemented Public Functions(可重写的公共函数)
- 1.minimumSizeHint函数--获取按钮的最小尺寸
- 2.sizeHint函数--获取按钮的推荐尺寸
- 五、Public Slots(公共槽函数)
- 1.showMenu函数--弹出菜单
- 六、Protected Functions(受保护的函数)
- 1.initStyleOption函数--用于初始化 QStyleOptionButton 结构体
- 七、Reimplemented Protected Functions(可重写的受保护的函数)
QAbstractButton类详解:https://liujie.blog.csdn.net/article/details/140490511
一、QPushButton介绍
QPushButton是任何图形用户界面中最常用的控件。按下(点击)按钮来命令计算机执行某个操作。典型的按钮有“确定”、“应用”、“取消”、“关闭”、“是”、“否”和“帮助”。按钮显示文本标签,可以通过在文本中用和号(&)前缀来指定快捷键;还可以选择性地显示一个小图标。
按钮中重要的模式或状态包括:
- 可用或不可用(变灰,禁用)。
- 标准按钮、菜单按钮。
- 默认或正常。对话框中的默认按钮通常可以使用 Enter 或 Return 键“点击”。
- 是否自动重复。
- 是否按下。
按钮的一个变体是菜单按钮。这些不仅提供一条命令,还提供多个命令,因为当它们被点击时,它们会弹出一个选项菜单。使用 setMenu()
方法将弹出菜单与按钮关联。
按钮的使用方式:
Header:
#include <QPushButton>
qmake:
QT += widgets
二、Properties(属性)
-
autoDefault : bool – 按钮是否是自动默认按钮
-
属性说明:
这个属性用于控制按钮是否是自动默认按钮。设置为
true
时,按钮将被识别为自动默认按钮。在某些 GUI 风格中,默认按钮会绘制一个额外的边框,宽度可达 3 像素或更多。如果按钮有一个 QDialog 父对象,则这个属性的默认值是 true;否则默认为 false。
-
访问函数:
bool autoDefault() const //获取当前的自动默认状态 void setAutoDefault(bool) //设置自动默认状态
-
注意事项:
default
属性和autoDefault
属性之间存在交互关系
-
-
default : bool – 按钮是否是默认按钮
-
属性说明:
这个属性用于决定按钮是否是默认按钮。
默认按钮和自动默认按钮决定了当用户在对话框中按下回车键时会发生什么。如果设置了
default
属性为true
,则该按钮将成为对话框中的默认按钮,通常在用户按下回车时自动被激活。 -
访问函数:
bool isDefault() const //检查按钮是否是默认按钮 void setDefault(bool) //设置按钮是否为默认按钮
-
注意事项:
- 存在一个例外情况:如果当前有焦点的按钮是自动默认按钮,那么即使
default
属性为true
的按钮存在,也会优先激活有焦点的自动默认按钮。 - 默认按钮的行为是对话框特有的,但所有按钮都可以通过空格键在获得焦点时从键盘上被激活。
- 在对话框中,一次只能有一个按钮是默认按钮。这个按钮会显示一个额外的边框(取决于 GUI 风格)
- 存在一个例外情况:如果当前有焦点的按钮是自动默认按钮,那么即使
-
-
flat : bool – 按钮边框是否凸起
-
属性说明:
这个属性用于控制按钮边框是否凸起。
- 当
flat
属性为false
(默认值),按钮通常会有一个凸起的边框,这是大多数按钮的常见样式。 - 当
flat
属性设置为true
,按钮的边框将不会显示为凸起,这可以使按钮看起来更平滑或更现代。在这种状态下,如果按钮没有被按下,大多数GUI风格可能不会绘制按钮的背景。 - 如果希望扁平按钮在未被按下时也有背景填充,可以使用
setAutoFillBackground(true)
,这样按钮的背景将使用QPalette::Button
画笔进行填充。
- 当
-
访问函数:
bool isFlat() const //检查按钮是否设置为扁平(无边框凸起) void setFlat(bool) //设置按钮是否应该是扁平的,即没有边框凸起
-
三、Public Functions(公共函数)
1.构造函数–构造按钮对象
QPushButton::QPushButton(const QIcon &icon, const QString &text, QWidget *parent = nullptr)
-
函数说明:
这是
QPushButton
的构造函数之一,允许同时指定按钮的图标和文本 -
参数说明:
icon
: 参数接受一个QIcon
对象,表示按钮上显示的图标。text
: 参数接受一个QString
对象,表示按钮上的文本。parent
: 参数指定按钮的父控件,如果提供nullptr
,则按钮没有父控件。
-
示例:
// 使用QIcon和QString创建按钮 QPushButton *buttonWithIconAndText = new QPushButton(QIcon("path/to/icon.png"), "Button with Icon and Text");// 使用QPixmap作为图标创建按钮 QPixmap pixmap("path/to/pixmap.png"); QPushButton *buttonWithPixmap = new QPushButton(QIcon(pixmap), "Button with QPixmap");
-
注意事项:
- C++的隐式类型转换允许将
QPixmap
对象直接传递给需要QIcon
参数的函数,这意味着可以直接使用QPixmap
作为按钮的图标。
- C++的隐式类型转换允许将
QPushButton::QPushButton(const QString &text, QWidget *parent = nullptr)
-
函数说明:
这是
QPushButton
的构造函数之一,允许指定按钮的文本。 -
示例:
QPushButton *button = new QPushButton("Click Me", &window); button->setGeometry(50, 50, 100, 30); // 设置按钮的位置和大小
2.autoDefault与setAutoDefault函数–获取/设置按钮的自动默认状态
用来获取/设置autoDefault 属性值。
bool autoDefault() const //获取当前的自动默认状态
void setAutoDefault(bool) //设置自动默认状态
示例:
QApplication app(argc, argv);QDialog dialog;
dialog.setWindowTitle("Auto Default Button Example");QPushButton *button1 = new QPushButton("Auto Default", &dialog);
button1->setAutoDefault(true); // 设置为自动默认按钮QPushButton *button2 = new QPushButton("Not Auto Default", &dialog);
button2->setAutoDefault(false); // 不设置为自动默认按钮
button2->setGeometry(50, 50, 200, 50);
dialog.resize(300, 100);
dialog.show();
当用户在对话框中按下回车键时,如果第一个按钮(“Auto Default”)有焦点,则会自动被激活。如果没有按钮有焦点,则会激活下一个自动默认按钮。第二个按钮(“Not Auto Default”)不会自动被激活,除非用户直接点击它。
3.isDefault与setDefault函数-- 获取/设置按钮的默认状态
用来获取/设置default 属性值。
bool isDefault() const //检查按钮是否是默认按钮
void setDefault(bool) //设置按钮是否为默认按钮
示例:
QDialog dialog;
dialog.setWindowTitle("Default Button Example");QPushButton *defaultButton = new QPushButton("OK", &dialog);
defaultButton->setDefault(true); // 设置为默认按钮QPushButton *otherButton = new QPushButton("Cancel", &dialog);
// otherButton 不设置为默认按钮
otherButton->setGeometry(50, 50, 100, 50);dialog.resize(300, 100);
dialog.show();
当用户在对话框中按下回车键时,“OK” 按钮将自动被激活,因为它被设置为默认按钮。如果 “OK” 按钮没有焦点,并且对话框中有其他自动默认按钮,那么有焦点的自动默认按钮将被激活。
4.isFlat与setFlat函数–获取/设置按钮边框是否凸起
用来获取/设置flat 属性值。
bool isFlat() const //检查按钮是否设置为扁平(无边框凸起)
void setFlat(bool) //设置按钮是否应该是扁平的,即没有边框凸起
示例:
// 创建一个按钮,并设置为扁平样式
QPushButton *button = new QPushButton("Flat Button");
button->setFlat(true); // 设置按钮为扁平样式// 确保即使按钮扁平,背景也被填充
button->setAutoFillBackground(true);
5.menu与setMenu函数–获取/设置与按钮关联的弹出菜单(菜单按钮)
QMenu *QPushButton::menu() const
-
函数说明:
用于获取与按钮关联的弹出菜单(
QMenu
对象)的指针。弹出菜单通常用于创建下拉菜单或右键菜单,提供按钮的附加选项或操作。如果按钮设置了弹出菜单,此函数返回该菜单的指针;如果尚未设置弹出菜单,函数返回nullptr
。
void QPushButton::setMenu(QMenu *menu)
-
函数说明:
允许将一个
QMenu
对象与按钮关联。当一个按钮与菜单关联后,点击按钮会显示这个菜单,这样的按钮通常称为菜单按钮。 -
示例:
QPushButton *menuButton = new QPushButton("Options", &window); menuButton->setGeometry(50, 50, 100, 30); // 设置按钮的位置和大小// 创建一个菜单并添加一些动作 QMenu *menu = new QMenu(&window); menu->addAction("Open"); menu->addAction("Save"); menu->addSeparator(); menu->addAction("Exit");// 将菜单与按钮关联 menuButton->setMenu(menu);
-
注意事项:
- 通过
setMenu
关联菜单时,按钮不会接管菜单的所有权。这意味着QMenu
对象的生命周期需要由其他地方管理,以确保在按钮使用期间菜单是有效的。
- 通过
四、Reimplemented Public Functions(可重写的公共函数)
1.minimumSizeHint函数–获取按钮的最小尺寸
[override virtual] QSize QPushButton::minimumSizeHint() const
-
函数说明:
这个函数提供了控件的最小建议尺寸。重写
minimumSizeHint()
的目的是提供特定于按钮的最小尺寸 -
示例:
QPushButton button("Click Me"); // 获取并打印按钮的最小尺寸提示 QSize minSize = button.minimumSizeHint(); qDebug() << "Minimum size hint:" << minSize.width() << "x" << minSize.height(); //Minimum size hint: 93 x 28
2.sizeHint函数–获取按钮的推荐尺寸
[override virtual] QSize QPushButton::sizeHint() const
-
函数说明:
这个函数提供了控件的推荐尺寸。重写
sizeHint()
函数是QPushButton
类的一个特性,允许它根据按钮的特定需求来调整推荐尺寸。 -
示例:
// 获取并打印按钮的推荐尺寸 QSize sizeHint = button->sizeHint(); qDebug() << "Button size hint:" << sizeHint.width() << "x" << sizeHint.height(); //Button size hint: 93 x 28
五、Public Slots(公共槽函数)
1.showMenu函数–弹出菜单
[slot] void QPushButton::showMenu()
-
函数说明:
槽函数
showMenu()
用于显示与按钮关联的弹出菜单。在实际应用中,这通常会由用户的点击事件触发
六、Protected Functions(受保护的函数)
1.initStyleOption函数–用于初始化 QStyleOptionButton 结构体
[protected] void QPushButton::initStyleOption(QStyleOptionButton *option) const
-
函数说明:
-
initStyleOption()
函数用于初始化QStyleOptionButton
结构体。这个结构体包含了绘制按钮所需的所有信息,如按钮的尺寸、文本、图标、状态等。 -
通过调用
initStyleOption()
,子类可以快速获取一个填充了QPushButton
相关信息的QStyleOptionButton
实例,而无需手动设置每一个属性。 -
在自定义按钮绘制时非常有用,开发者可以通过继承
QPushButton
并重写绘制函数(如paintEvent()
),来实现自定义的按钮外观。 -
QStyleOption::initFrom()
允许从现有的控件初始化QStyleOption
结构体。
-
-
示例:
class CustomButton : public QPushButton { protected:void paintEvent(QPaintEvent *event) override {QStyleOptionButton option;initStyleOption(&option);QPainter painter(this);// 自定义绘制逻辑painter.setPen(Qt::NoPen);painter.setBrush(Qt::red);painter.drawEllipse(option.rect);// 绘制文本painter.setPen(Qt::black);painter.drawText(option.rect, Qt::AlignCenter, option.text);} };
上述是一个简单的自定义按钮。通过创建了一个继承自
QPushButton
的CustomButton
类,并重写了paintEvent()
函数。在paintEvent()
中,我们调用initStyleOption()
来初始化QStyleOptionButton
结构体,并使用它来绘制一个红色的圆形按钮和文本。
七、Reimplemented Protected Functions(可重写的受保护的函数)
下面这些函数一般用于自定义按钮时,大多数是事件函数,hitButton
函数用于调整区域(给定的坐标点 pos
是否在按钮的内部区域)。