QAbstractButton类

已于 2024-02-16 13:08:56 修改
阅读量949 收藏 22
点赞数 15
分类专栏： QT笔记 文章标签： 开发语言 qt
于 2024-02-04 17:01:24 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/floatBit/article/details/136028671
版权

 QAbstractButton类是按钮控件的抽象基类，提供按钮通用的功能。

Header:#include <QAbstractButton>
CMake:find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake:QT += widgets
Inherits:

 <<< QWidget

Inherited By:

复选按钮  QCheckBox

普通按钮  QPushButton >>>

单选按钮  QRadioButton

工具栏按钮  QToolButton

【详细说明】

QAbstractButton类是按钮控件的基类，它实现一个抽象按钮，它的子类处理用户操作，由用户指定如何绘制按钮。

QAbstractButton 提供对普通按钮和可检查（可切换）按钮的支持。可检查按钮在 QRadioButton 和QCheckBox 类中实现。普通按钮在 QPushButton和QToolButton类中实现，如果需要，它们还提供切换行为。

任何按钮都可以显示包含文本和图标的标签。

setText() 设置文本；

setIcon() 设置图标。

如果按钮被禁用，其"disabled" 标签将被更改，使按钮具有“禁用”外观。

如果该按钮是一个文本按钮，并且其中包含（“&”），则该按钮会自动创建一个快捷键。

QPushButton *button = new QPushButton(tr("Ro&ck && Roll"), this);

如上，快捷方式被分配给按钮，当用户按下Alt+C时该按钮将调用animateClick()（参阅 QShortcut）。

可使用“&&”显示实际的&字符。

对于没有任何文本的按钮，用户还可以用setShortcut() 函数来设置自定义快捷键。

button->setIcon(QIcon(":/images/print.png"));
button->setShortcut(tr("Alt+F7"));

Qt提供的所有（4种）按钮都可以同时显示 text 和 icons。

可以通过 QPushButton::setDefault()和 QPushButton::setAutoDefault() 将按钮设为对话框中的默认按钮。

★  QAbstractButton 提供用于按钮的大多数状态：

  • isDown() 指示是否按下该按钮。
  • isChecked() 表示是否是“可检查”按钮，即：只能选中和取消选中的按钮（见下文）。
  • isEnabled() 是否可用，即用户是否可以按下该按钮。
  • setAutoRepeat() 设置用户按住按钮是否会自动重复。自动重复延迟 autoRepeatDelay和 自动重复间隔autoRepeatInterval 定义了如何完成自动重复。
  • setCheckable()  可设置该按钮是否为切换按钮。

    注意：与其他控件不同，从QAbstractButton类派生的按钮在禁用时也接受鼠标和上下文菜单事件。

★   isDown() ()和isChecked() 的区别如下。当用户单击一个可切换按钮进行检查时，首先按下pressed该按钮，然后释放到选中checked状态。当用户再次单击它（取消选中它）时，按钮首先是按下pressed状态，然后进入未选中unchecked状态（isChecked()和 isDown() 都是false）。

QAbstractButton类提供四个信号：

  1. pressed() ：当鼠标光标在按钮内并按下鼠标左键时发出。
  2. released() ：当鼠标左键释放时发出。
  3. clicked() ：此信号在首次按下然后松开按钮时、键入快捷键或调用 click() 或 animateClick() 时发出。
  4. toggled() ：在可切换按钮的状态发生变化时发出。

★ 实现QAbstractButton的子类时，必须重新实现 paintEvent() 以绘制按钮的轮廓及其文本或像素图。通常建议重新实现“控件推荐尺寸” sizeHint() ，有时也建议重新实现“可点击区域”hitButton() （以确定按下动作是否在按钮内）。对于具有两个以上状态的按钮（如三态按钮），您还须重新实现检查状态checkStateSet() 和下一个检查状态nextCheckState()。

【属性】

autoExclusive : bool

此属性保存是否启用了自动独占性。除单选按钮外，自动独占性默认处于关闭状态。

如果启用了自动独占性，则属于同一父控件的可检查按钮的行为就像它们是同一独占按钮组的一部分一样。在专属按键组中，任何时候只能勾选一个按键；选中另一个按钮会自动取消选中之前选中的按钮。

autoRepeat : bool

此属性决定是否启用自动重复。

如果启用了自动重复，则 pressed(), released()和 clicked()按钮按下时，会定期发出信号。默认情况下，自动重复是关闭的。初始延迟和重复间隔由autoRepeatDelay 和 autoRepeatInterval.下式义，单位为毫秒。

注意:如果通过快捷键按下按钮，则自动重复由系统而不是该类启用和计时。

autoRepeatDelay : int

该属性保存自动重复的初始延迟，如 autoRepeat 当前可用，则由此属性定义自动重复开始之前的初始延迟（毫秒）。

autoRepeatInterval : int

该属性保存自动重复的间隔。

 如 autoRepeat 当前可用，则由此属性定义自动重复间隔的长度。

checkable : bool

该属性决定按钮是否"可检查"，默认按钮不可检查。

checked : bool

该属性保存按钮是否被选中。

只能检查”可检查“的按钮。默认按钮处于未选中状态。

down : bool

该属性保存按钮是否被按下。

按钮被按下时该属性为true。如果将此属性设置为true，不会发出pressed() 和 clicked() 信号。默认值为false。

icon : QIcon

该属性保存按钮图标。

图标的默认大小由GUI样式定义，但可以设置iconSize。

iconSize : QSize

该属性保存用于该按钮的图标大小。

这是图标的最大尺寸，较小的图标并不会被放大。

shortcut : QKeySequence

此属性保存与按钮关联的快捷方式。

text : QString

该属性保存按钮上显示的文本。

如果按钮没有文本，text()函数将返回一个空字符串。

如果文本包含一个（&），将自动为其创建一个快捷方式。“&”后面的字符将用作快捷键。如果文本没有定义快捷方式，任何以前的快捷方式都将被覆盖或清除。要显示实际的&符号，请使用“&&”。

【公共函数】

QAbstractButton(QWidget *parent = nullptr)构造一个抽象按钮。
virtual~QAbstractButton()
boolautoExclusive() const返回是否启用自动独占性。
boolautoRepeat() const返回是否启用自动重复。
intautoRepeatDelay() const返回自动重复的初始延迟。
intautoRepeatInterval() const返回自动重复的间隔。
QButtonGroup *group() const返回此按钮所属的组。
QIconicon() const返回按钮上显示的图标。
QSizeiconSize() const返回图标尺寸。
boolisCheckable() const返回是否可检查。
boolisChecked() const返回是否选中按钮。
boolisDown() const返回是否按下按钮。
voidsetAutoExclusive(bool)设置自动独占性。
voidsetAutoRepeat(bool)设置自动重复。
voidsetAutoRepeatDelay(int)设置自动重复的初始延迟。
voidsetAutoRepeatInterval(int)设置自动重复的间隔。
voidsetCheckable(bool)设置按钮状态。
voidsetDown(bool)设置按下按钮。
voidsetIcon(const QIcon &icon)设置图标。
voidsetShortcut(const QKeySequence &key)设置快捷方式。
voidsetText(const QString &text)设置文本。
QKeySequenceshortcut() const返回快捷方式。
QStringtext() const返回按钮文本。

【公有槽函数】

voidanimateClick()

执行按下按钮动作，并在 100 毫秒后松开。发出与点击相关的信号。在松开按钮之前再次调用此函数将重置释放计时器。如果按钮是 disabled，则不执行任何操作。

voidclick()

执行单击。发出与点击相关的信号。如果按钮可选中，则切换按钮的状态。 如果按钮是 disabled，则不执行任何操作。

voidsetChecked(bool)设置选中按钮状态。
voidsetIconSize(const QSize &size)设置图标尺寸。
voidtoggle()

切换可检查按钮的状态。

【信号】

voidclicked(bool checked = false)

当按钮被激活时（当鼠标光标在按钮内时按下然后松开），键入快捷键或调用 click() 或 animateClick()时，会发出此信号。值得注意的是，如果调用 l setDown(), setChecked() 或 toggle()，并不会发出此信号。

如果按钮可选中，则为true（如果按钮处于选中状态）或false （如果按钮未选中）。

voidpressed()按下按钮时会发出此信号。
voidreleased()松开按钮时会发出此信号。
voidtoggled(bool checked)

属性的通知器信号。每当可检查按钮更改其状态时，都会发出此信号。如果按钮处于选中状态，则为 true；如果按钮未选中，则为 false。

这可能是用户 click()槽激活的结果，也可能是因为调用了 setChecked() 。

在发出此信号之前，会更新独占按钮组中按钮的状态。这意味着槽可以作用于状态已更改的组中的按钮，发出的“关闭”信号或“打开”信号。

例如，可以使用以下模式实现对新选中的按钮发出的信号做出反应但忽略来自未选中按钮的信号的插槽：

void MyWidget::reactToToggle(bool checked)
{
   if (checked) {
      // Examine the new button states.
      ...
   }
}

可以使用该类创建按钮组 QButtonGroup，并使用  QButtonGroup::buttonClicked() 信号监视按钮状态的更新。

【受保护函数】

virtual voidcheckStateSet()此虚拟处理程序在使用 setChecked() 时调用，除非它是从 nextCheckState() 内部调用的。它允许子类重置其中间按钮状态。
virtual boolhitButton(const QPoint &pos) const

返回是否在可单击的按钮矩形内。

默认情况下，可点击区域是整个控件。子类可以重新实现此功能，以提供对不同形状和大小的可单击区域的支持。

virtual voidnextCheckState()单击按钮时调用此虚拟处理程序。默认实现调用 setChecked( ! isChecked()) 如果按钮 isCheckable()。它允许子类实现中间按钮状态。

【重实现的保护函数】

virtual void

changeEvent(QEvent *e) override

重实现了其父类 < QWidget 中对应的虚函数。
virtual boolevent(QEvent *e) override
virtual voidfocusInEvent(QFocusEvent *e) override
virtual voidfocusOutEvent(QFocusEvent *e) override
virtual voidkeyPressEvent(QKeyEvent *e) override
virtual voidkeyReleaseEvent(QKeyEvent *e) override
virtual voidmouseMoveEvent(QMouseEvent *e) override
virtual voidmousePressEvent(QMouseEvent *e) override
virtual voidmouseReleaseEvent(QMouseEvent *e) override
virtual voidpaintEvent(QPaintEvent *e) override = 0
virtual voidtimerEvent(QTimerEvent *e) override

<<< 返回上一级【QWidget】 

<<< 返回根页面

floatbit
关注
  • 15
    点赞
  • 踩
  • 22
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
QT软件开发之基础控件--2.1.1 QAbstractButton类
10-14 310
2.1 按钮控件组 QT Creator UI设计师界面的按钮组截图如下： 图2-1按钮控件组 以下是对按钮组控件的一些功能介绍： 1.Push Button按压按钮：最普通的按钮，按(点击)按钮命令计算机执行一些动作，或者回答问题，比如windows开始菜单里的重启，注销，关机等按钮。 2.Tool Button工具按钮：工具按钮通常是一个集合，一般集成在工具栏里。比如打开，保存，复制，粘贴，剪切等常用的操作。 3.Radio Button单选按钮：单选按钮通常是两个以上的形式出现在一块，
PyQt5基本窗口控件—–QPushButton
12-22
PyQt5学习之路，点击有pyqt5学习笔记 按钮的基类是QAbstractButton，该类为抽象类，不能实例化，必须由其他按钮类去继承。 常见的按钮类： QPushButton:最普通辣个按钮 QToolButton: 工具条按钮 QRadioButton：单选按钮 QCheckBox：复选框 import sys from PyQt5.QtGui import * from PyQt5.QtWidgets import * class QPushButtonDemo(QDialog): def __init__(self): super(QPushButtonDe
QAbstractButton部分子类图
04-15
QAbstractButton的子类有： 1. QPushButton: 提供了一个可以点击的按钮。 2. QRadioButton: 提供了一个单选按钮。 3. QCheckBox: 提供了一个多选按钮。 4. QToolButton: 提供了一个更小的按钮，通常用于工具栏上。 5. QCommandLinkButton: 提供了一个带有说明文本的按钮。 6. QDialogButtonBox：通常用于创建对话框，并提供了一组预定义的按钮，如Ok、Cancel、Apply等
qt，qss通用样式文件
06-22
qt，qss通用样式文件
python GUI库图形界面开发之PyQt5单选按钮控件QRadioButton详细使用方法与实例
12-20
PyQt5单选按钮控件QRadioButton简介 QRadioButton 继承自 QAbstractButton，其主要作用提供用户一些互斥的按钮。 QRadioButton 只有一个的时候，功能类似于复选框， 可以选择和取消，但是如果有多个，则必须有一个被选中 QRadioButton类中常用的方法 方法 描述 setCheckanle() 设置按钮是否已经被选中，可以改变单选按钮的选中状态，如果设置为True则表示单选按钮将保持以点击和释放状态 isChecked() 返回单选按钮的状态，返回值True或False setText() 设置单选按钮显示的文本
python GUI库图形界面开发之PyQt5切换按钮控件QPushButton详细使用方法与实例
01-21
PyQt5切换按钮控件QPushButton简介 QAbstractButton类为抽象类，不能实例化，必须由其他的按钮类继承QAbstractButton类，来实现不同的功能和表现形式，常见的按钮QPushButton，QToolButton，QRadioButton和QCheckBox这些按钮均继承自QAbstractButton类，根据各自的使用场景通过图形显示出来 QAbstractButton提供的状态如下表 状态 含义 isDown() 提示按钮是否已按下 isChecked() 提示按钮是否已经标记 isEnable() 提示按钮是否可以被用户点击 is
Qt学习总结之QAbstractButton类
qq_27726087的博客
08-05 489
按钮的基类是QAbstractButton，提供了按钮的通用性功能。QAbstractButton类为抽象类，不能实例化，必须由其他的按钮类继承QAbstractButton类，来实现不同的功能、不同的表现形式。
QAbstractButton类概述
qq_33263769的博客
11-20 243
        QAbstractButton 类是 QPushButton，QCheckBox，QRadioButton 等类的基类，它可以代表按钮、单选纽、复选纽等重要窗口部件。通常不会直接使用这个类，这里主要介绍它的一些属性、信号和槽，介绍时暂时将这些窗口部件统称为钮。         属性         checkable 属性代表钮是否支持开关状态，比如按钮一般没有开关状态，而单选...
Qt开发：Qt Widgets模块——QAbstractButton类
一世豁然的专栏
05-15 2543
QAbstractButton类是按钮小部件的抽象基类，提供按钮通用的功能。这个类实现了一个抽象按钮。 此类的子类处理用户操作，并指定按钮的绘制方式。头文件：#include &lt;QAbstractButton&gt; qmake：QT += widgets继承：QWidget被继承：QCheckBox, QPushButton, QRadioButton, and QToolButton一、...
基本Widgets(03)：【类】QAbstractButton[官翻]
读书笔记
01-24 224
文章目录详细说明属性排他自动重复可检查(可选中)图表助记符文本公共函数构造析构属性相关特殊公共槽信号受保护的函数重新实现的受保护的函数 QAbstractButton Class QAbstractButton类是按钮小部件的抽象基类，提供按钮常见的功能。 Header #include < QAbstractButton > qmake QT += widgets Inherits QWidget Inherited By QCheckBox, QPushButt
Qt | QAbstractButton 抽象类
m0_45463480的博客
04-26 175
QAbstractButton 抽象类
按钮控件的基类--- QAbstractButton 类（抽象类）
zxf347085420的博客
09-05 250
设置为 true，则不会发送 pressed()和 clicked()信号(经测试，仍会发送这些信号)。 若按钮是可选中的， 当按钮被选中时， 参数 checked 为 true，若按钮未被选中，默认按钮无效，也就是按下 enter 键时，即使关闭自动重复，默认按钮仍会重复发送。按钮是否被选中(即是否处于选中状态)，只有可选中按钮才能被选中。描述了按钮的自动排他性，若启用了该属性，则属于同一父部件的可选中按钮的行为，此槽接收来自与点击相关的常见信号，若按钮是可选中的，则切换该按钮的状态。
Qt6入门教程 12：QAbstractButton
草上爬的博客
01-28 2582
继承QAbstractButton，你至少得重新实现paintEvent()来绘制按钮的外形、文本和图标。通常也建议重新实现sizeHint()，某些情况下还得重新实现hitButton()（判断鼠标是否在按钮区域内）。下面的代码中集成QAbstractButton实现了MyButton，重新实现了paintEvent。在paintEvent中绘制文本颜色为白色，按钮底色为蓝色（鼠标按下或按钮选中时为红色）。代码中涉及的绘图和布局知识后面会单独介绍。
聊一聊开发语言的基础控制结构
m0_46552684的博客
05-28 1560
一、描述下for循环、while循环和do-while循环的区别和用法。在编程中，for循环、while循环和do-while循环是用于重复执行一段代码直到满足特定条件的控制结构。每种循环都有其特定的用途和语法。
Qt lambda 表达式
github_37290846的博客
05-29 524
在 Qt 中，lambda 表达式经常用于定义槽函数，特别是在需要快速响应信号而无需编写单独的成员函数时。Lambda 表达式在 C++11 中被引入，它允许你定义一个匿名函数（即没有名字的函数）并直接在代码中捕获和使用它。当按钮被点击时，lambda 表达式中的代码将被执行，输出一条消息到调试控制台。总之，lambda 表达式在 Qt 中为信号和槽的连接提供了一种灵活且强大的方式，使得你可以在不定义额外成员函数的情况下快速响应信号。
CMake是怎么找到Qt相关模块的
FUHAILIANG_2015的博客
05-28 370
一般我们不会在CMakeLists里面硬编码CMAKE_PREFIX_PATH，推荐通过环境变量找到模块。深入了解find_package之后，我们就明白COMPONENTS其实是一个选项，列出来了必选的模块。当我们使用QT创建了一个CMake项目后，我们尝试使用CMake编译时，会遇到找不到Qt的模块的问题，Qt的模块是放在Qt/5.15.2/clang_64/lib/cmake，所以我们只需要配置。记得将QT_DIR环境变量放到PATH中，因为find_package会从PATH中寻找。
【Qt之·类QCoreApplication】
m0_66203017的博客
05-28 1061
介绍Qt是一个跨平台的C++开发框架，具有强大的功能和易于使用的API。其中，是Qt框架中负责管理应用程序的类。本文将介绍QCoreApplication的作用、使用方法以及常用功能。QCoreApplication类用于应用程序的初始化和退出，可以在构造函数中进行应用程序的初始化操作，并在需要时调用quit()函数来退出应用程序。QCoreApplication提供了事件循环机制和事件处理函数，用于处理来自操作系统和其他组件的事件，如鼠标点击、键盘输入等。
QT截图程序，可多屏幕截图二，增加调整截图区域功能
最新发布
gdizcm的专栏
05-29 615
截屏增加动态调整边框功能
QAbstractButton
05-24
QAbstractButton 是 Qt 框架中的一个抽象类，用于实现按钮的基本功能。它是 QPushButton、QRadioButton 和 QCheckBox 等按钮类的基类，提供了一些公共的接口和信号槽。 QAbstractButton 类主要包括以下几个方面的...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值