当前位置：首页 > news >正文

Qt应用开发(基础篇)——工具按钮类 QToolButton

news 2025/7/15 5:14:10

一、前言

QToolButton类继承于QAbstractButton，该部件为命令或选项提供了一个快速访问按钮，通常用于QToolBar中。

按钮基类 QAbstractButton

QToolButton是一个特殊的按钮，一般显示文本，只显示图标，结合toolBar使用。它提供对特定命令或选项的快速访问，与普通的命令按钮相反，工具按钮通常不显示文本标签，而是显示一个图标。

QToolButton工具按钮通常是QToolBar在使用addAction()创建新的QAction实例时创建的。也可以以与任何其他小部件相同的方式构造工具按钮，并将它们与布局中的其他小部件一起排列。

QAction *act1 = new QAction("上");
QAction *act2 = new QAction("左");
QAction *act3 = new QAction("下");
QAction *act4 = new QAction("右");QToolButton *btn1 = new QToolButton;
btn1->setArrowType(Qt::UpArrow);
QToolButton *btn2 = new QToolButton;
btn2->setArrowType(Qt::LeftArrow);
QToolButton *btn3 = new QToolButton;
btn3->setArrowType(Qt::DownArrow);
QToolButton *btn4 = new QToolButton;
btn4->setArrowType(Qt::RightArrow);QToolBar *bar = new QToolBar(this);
bar->setFixedWidth(500);
bar->setFixedHeight(50);
bar->addAction(act1);
bar->addAction(act2);
bar->addAction(act3);
bar->addAction(act4);  
bar->addAction(QApplication::style()->standardIcon(QStyle::SP_MessageBoxInformation),"");  
bar->addAction(QApplication::style()->standardIcon(QStyle::SP_MessageBoxWarning),""); 
bar->addAction(QApplication::style()->standardIcon(QStyle::SP_MessageBoxCritical),"");
bar->addAction(QApplication::style()->standardIcon(QStyle::SP_MessageBoxQuestion),"");
bar->addWidget(btn1);
bar->addWidget(btn2);
bar->addWidget(btn3);
bar->addWidget(btn4);

QToolButton可以设置icon图标，当按钮的功能不可用时使用禁用的像素图，当按钮自动抬起时，由于鼠标指针悬停在活动像素图上，显示活动像素图。也可以使用arrowType显示箭头图标，参考上文示例。

二：QToolButton 类

1、arrowType

该属性用于是否是箭头图标，参考上文示例。

Qt::ArrowType arrowType() const         
void setArrowType(Qt::ArrowType type）

2、autoRaise

该属性用于是否自动升高模式。在自动升高模式下，按钮在鼠标指向它时绘制3D帧。当在QToolBar中使用按钮时，该功能会自动打开，也就是说不要在QToolBar使用该按钮之前调用setAutoRaise，否则会被重置回去。

bool autoRaise() const            
void setAutoRaise(bool enable)

在示例中添加设置toolbutton1的autoRaise为false。

btn1->setAutoRaise(false);

3、popupMode

该属性表示按钮与弹出菜单的交互方式，默认为QToolButton::DelayedPopup。

QToolButton::ToolButtonPopupMode popupMode() const          
void setPopupMode(QToolButton::ToolButtonPopupMode mode)

QToolButton::ToolButtonPopupMode 描述
QToolButton::DelayedPopup 在按住工具按钮一段时间后显示菜单
QToolButton::MenuButtonPopup 工具按钮显示一个特殊的箭头，以指示存在菜单。当按下按钮的箭头部分时，将显示菜单。
QToolButton::InstantPopup 按下工具按钮，菜单立即显示。在这种模式下，按钮本身的动作不会被触发

QToolButton::ToolButtonPopupMode	描述
QToolButton::DelayedPopup	在按住工具按钮一段时间后显示菜单
QToolButton::MenuButtonPopup	工具按钮显示一个特殊的箭头，以指示存在菜单。当按下按钮的箭头部分时，将显示菜单。
QToolButton::InstantPopup	按下工具按钮，菜单立即显示。在这种模式下，按钮本身的动作不会被触发

4、toolButtonStyle

该属性用于确定图标和文本的显示策略，默认为Qt::ToolButtonIconOnly。

Qt::ToolButtonStyle toolButtonStyle() const       
void setToolButtonStyle(Qt::ToolButtonStyle style)

Qt::ToolButtonStyle 描述
Qt::ToolButtonIconOnly 只显示图标
Qt::ToolButtonTextOnly 只显示文本
Qt::ToolButtonTextBesideIcon 文本在图标旁边
Qt::ToolButtonTextUnderIcon 文本在图标下面
Qt::ToolButtonFollowStyle 跟随系统

Qt::ToolButtonStyle	描述
Qt::ToolButtonIconOnly	只显示图标
Qt::ToolButtonTextOnly	只显示文本
Qt::ToolButtonTextBesideIcon	文本在图标旁边
Qt::ToolButtonTextUnderIcon	文本在图标下面
Qt::ToolButtonFollowStyle	跟随系统