简述
QToolButton类让我们可以快速地实现命令和选项按钮,它通常用在QToolBar中。
相比于普通的命令按钮(QPushButton),工具按钮通常不显示文本,只显示图标。
工具按钮通常是在QToolBar::addAction方法被调用的时候被创建。当然,也可以用其它控件的创建方式来创建QToolButton。
QToolButton的一种经典用法是选择工具。例如,绘图程序中的“笔”工具。
基本用法
下面我们利用QToolButton的一些基本属性做一个演示。
效果
这个例子中使用了四个QToolButton,每个按钮展示不同的属性。按钮顺序:自左向右升序。
源码
QToolButton *toolBtn1 = new QToolButton;
toolBtn1->setArrowType(Qt::LeftArrow);
toolBtn1->setAutoRaise(true);
QToolButton *toolBtn2 = new QToolButton;
toolBtn2->setArrowType(Qt::LeftArrow);
QToolButton *toolBtn3 = new QToolButton;
toolBtn3->setIcon(QIcon(":/picture/tool.png"));
QToolButton *toolBtn4 = new QToolButton;
toolBtn4->setPopupMode(QToolButton::MenuButtonPopup);
QMenu *menu = new QMenu;
menu->addAction("剪切");
menu->addAction("粘贴");
menu->addAction("复制");
toolBtn4->setMenu(menu);
QHBoxLayout *layout = new QHBoxLayout;
layout->addWidget(toolBtn1);
layout->addWidget(toolBtn2);
layout->addWidget(toolBtn3);
layout->addWidget(toolBtn4);
this->setLayout(layout);
常用接口
下面列举QToolButton中一些常用的属性、公有函数以及信号槽。
常用属性
- arrowType:Qt自带的一些默认图标
常量 | 值 |
---|---|
Qt::NoArrow | 0 |
Qt::UpArrow | 1 |
Qt::DownArrow | 2 |
Qt::LeftArrow | 3 |
Qt::RightArrow | 4 |
- popupMode:QToolButton上面的菜单弹起模式
常量 | 值 | 描述 |
---|---|---|
QToolButton::DelayedPopup | 0 | 按下按钮一定时间后显示菜单。一个典型案例:浏览器中工具栏的“后退”按钮。 |
QToolButton::MenuButtonPopup | 1 | 这种模式下,工具按钮显示一个特殊的箭头以指示菜单是否存在,按下按钮的箭头部分时显示菜单。 |
QToolButton::InstantPopup | 2 | 按下工具按钮时菜单显示,无延迟。这种模式下,按钮自身的动作不触发。 |
- toolButtonStyle
常量 | 值 | 描述 |
---|---|---|
Qt::ToolButtonIconOnly | 0 | 只显示图标 |
Qt::ToolButtonTextOnly | 1 | 只显示文本 |
Qt::ToolButtonTextBesideIcon | 2 | 文本显示在图标旁边 |
Qt::ToolButtonTextUnderIcon | 3 | 文本显示在图标下面 |
Qt::ToolButtonFollowStyle | 4 | 样式跟随 |
效果
源码
QToolButton *toolBtn1 = new QToolButton;
toolBtn1->setToolButtonStyle(Qt::ToolButtonTextUnderIcon);
toolBtn1->setIcon(QIcon(":/picture/tool.png"));
toolBtn1->setText("我在Icon下面");
QToolButton *toolBtn2 = new QToolButton;
toolBtn2->setToolButtonStyle(Qt::ToolButtonTextBesideIcon);
toolBtn2->setIcon(QIcon(":/picture/tool.png"));
toolBtn2->setText("我在Icon旁边");
QHBoxLayout *layout = new QHBoxLayout;
layout->addWidget(toolBtn1);
layout->addWidget(toolBtn2);
this->setLayout(layout);
公共函数
- 设置箭头类型
- setArrowType(Qt::ArrowType type)
设置箭头
- 设置菜单
- setMenu
设置菜单到QToolButton
- 设置按钮自动凸起
- setAutoRaise
QToolButton支持auto-raising模式,在auto-raise模式下,只有当鼠标放在QToolButton上面时,它才会显示出一个3D状态。当QToolButton在QToolBar中被使用时,auto-raise模式默认启动。
- 设置菜单弹出模式
- setPopupMode
槽函数
- 设置按钮样式
- setToolButtonStyle
-
设置按钮默认行为
- setDefaultAction
给一个QToolButton设置一个默认QAction,这个QAction包含有该QToolButton需要的一些基本默认设置,包括:checkable;checked;enabled;font;icon;popupMode;statusTip;text;toolTip;whatThis
使用案例
QToolButton *toolBtn1 = new QToolButton;
QAction *action = new QAction;
action->setCheckable(true);
action->setChecked(true);
action->setEnabled(true);
action->setIcon(QIcon(":/picture/tool.png"));
toolBtn1->setDefaultAction(action);
QHBoxLayout *layout = new QHBoxLayout;
layout->addWidget(toolBtn1);
this->setLayout(layout);
- 展示下拉菜单
- showMenu
信号
- 触发
- triggered
引用
[1] Qt助手