Question

QToolButton类提供了用于命令或者选项的可以快速访问的按钮，通常可以用在QToolBar里面。 详情请见……

#include <qtoolbutton.h>

继承了QButton。

所有成员函数的列表。

公有成员

• QToolButton ( QWidget*parent, constchar*name = 0 )
• QToolButton ( constQIconSet&iconSet, constQString&textLabel, constQString&grouptext, QObject*receiver, constchar*slot, QToolBar*parent, constchar*name = 0 )
• QToolButton ( ArrowTypetype, QWidget*parent, constchar*name = 0 )
• ~QToolButton ()
• void setOnIconSet ( const QIconSet & ) （废弃）
• void setOffIconSet ( const QIconSet & ) （废弃）
• void setIconSet ( constQIconSet&set, boolon ) （废弃）
• QIconSet onIconSet () const （废弃）
• QIconSet offIconSet () const （废弃）
• QIconSet iconSet ( boolon ) const （废弃）
• virtual void setIconSet ( const QIconSet & )
• QIconSet iconSet () const
• bool usesBigPixmap () const
• bool usesTextLabel () const
• QString textLabel () const
• void setPopup ( QPopupMenu*popup )
• QPopupMenu * popup () const
• void setPopupDelay ( intdelay )
• int popupDelay () const
• void openPopup ()
• void setAutoRaise ( boolenable )
• bool autoRaise () const

公有槽

• virtual void setUsesBigPixmap ( boolenable )
• virtual void setUsesTextLabel ( boolenable )
• virtual void setTextLabel ( constQString&newLabel, booltipToo )
• virtual void setToggleButton ( boolenable )
• virtual void setOn ( boolenable )
• void toggle ()
• void setTextLabel ( const QString & )

属性

• bool autoRaise- 自动浮起是否生效
• QIconSet iconSet- 提供显示在按钮上的图标的图标集
• QIconSet offIconSet- 当按钮在“关”状态时使用的图标集（废弃）
• bool on- 工具按钮是否为开
• QIconSet onIconSet- 当按钮在“开”状态时使用的图标集（废弃）
• int popupDelay- 在按下按钮和出现关联的弹出按钮之间的以毫秒为单位的时间
• QString textLabel- 按钮的标签
• bool toggleButton- 工具按钮是否是切换按钮
• bool usesBigPixmap- 工具按钮是否使用大的像素映射
• bool usesTextLabel- 工具按钮是否在按钮像素映射下方显示标签

保护成员

• bool uses3D () const

---

详细描述

QToolButton类提供了用于命令或者选项的可以快速访问的按钮，通常可以用在QToolBar里面。

工具按钮是提供对特定命令或者选项快速访问的特殊按钮。和普通的命令按钮不同，工具按钮通常不显示文本标签，而是图标。它的经典用法事选择工具，例如在一个绘图程序中的“笔”工具。这个被QToolButton作为切换按钮重新实现。（请参考setToggleButton()）。

QToolButton支持自动浮起。在自动浮起模式中，按钮只有在鼠标指向它的时候才绘制三维的框架。当按钮被用在QToolBar里面的时候，这个特征会自动被启用。可以使用setAutoRaise()来改变它。

工具按钮的图标是被设置为QIconSet。这使得它可以为失效和激活状态指定不同的像素映射。当按钮的功能不可用的时候，失效的像素映射被使用。当因为用户用鼠标指向按钮而自动浮起时，激活的像素映射被显示。

按钮的外观和尺寸可以通过setUsesBigPixmap()和setUsesTextLabel()来调节。当被用在QToolBar里面时，按钮会自动地调节来适合QMainWindow的设置（请参考QMainWindow::setUsesTextLabel()和QMainWindow::setUsesBigPixmaps()）。

工具按钮可以提供一个弹出菜单的额外选择。这个特征有时对于网页浏览器中的“后退”按钮是有用的。在按下按钮一段时间之后，一个菜单会弹出来显示所有可以后退浏览的可能页面。你可以使用setPopup()来为QToolButton设置一个弹出菜单。默认延时是600毫秒，你可以使用setPopupDelay()来调节它。

一个有QToolbutton的浮动的QToolbar

也可以参考QPushButton、QToolBar、QMainWindow、图形用户界面设计手册：推动按钮和基本窗口部件。

---

成员函数文档

QToolButton::QToolButton ( QWidget*parent, constchar*name = 0 )

构造一个父对象为parent并且名称为name的空工具按钮。

QToolButton::QToolButton ( constQIconSet&iconSet, constQString&textLabel, constQString&grouptext, QObject*receiver, constchar*slot, QToolBar*parent, constchar*name = 0 )

构造一个父对象为parent（必须为QToolBar）并且名称为name的工具按钮。

工具按钮将显示iconSet，它的文本标签和工具提示设置为textLabel并且它的状态条信息设置为grouptext。它将被连接到receiver对象的slot槽。

QToolButton::QToolButton ( ArrowTypetype, QWidget*parent, constchar*name = 0 )

把工具按钮构造为箭头按钮。ArrowType type定义了箭头的方向。可用的值为LeftArrow、RightArrow、UpArrow和DownArrow。

箭头按钮的自动重复默认是打开的。

parent和name参数被发送给QWidget构造函数。

QToolButton::~QToolButton ()

销毁这个对象并且释放任何被分配的资源。

bool QToolButton::autoRaise () const

如果自动浮起有效，返回真，否则返回假。详细情况请参考“autoRaise”属性。

QIconSet QToolButton::iconSet () const

返回提供显示在按钮上的图标的图标集。详细情况请参考“iconSet”属性。

QIconSet QToolButton::iconSet ( boolon ) const

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

这个函数是废弃的。它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

从Qt 3.0开始，QIconSet可以包含开和关两套图标了。

为了方便移植，这个函数将忽略on参数并且返回iconSet属性。如果你依赖于on参数，你也许要把你的代码升级到QIconSet开/关机制了。

QIconSet QToolButton::offIconSet () const

返回当按钮在“关”状态下被使用的图标集。详细情况请参考“offIconSet”属性。

QIconSet QToolButton::onIconSet () const

返回当按钮在“开”状态下被使用的图标集。详细情况请参考“onIconSet”属性。

void QToolButton::openPopup ()

打开（弹出）关联的弹出菜单。如果没有这样的菜单，这个函数就什么也不做。直到这个弹出菜单已经被用户关闭，这个函数才会返回。

QPopupMenu* QToolButton::popup () const

返回关联的弹出菜单，或者如果没有定义弹出菜单，返回0。

也可以参考setPopup()。

int QToolButton::popupDelay () const

返回在按下按钮和出现关联的弹出按钮之间的以毫秒为单位的时间。详细情况请参考“popupDelay”属性。

void QToolButton::setAutoRaise ( boolenable )

设置自动浮起是否有效为enable。详细情况请参考“autoRaise”属性。

void QToolButton::setIconSet ( constQIconSet& ) [虚]

设置提供显示在按钮上的图标的图标集。详细情况请参考“iconSet”属性。

void QToolButton::setIconSet ( constQIconSet&set, boolon )

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

这个函数是废弃的。它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

从Qt 3.0开始，QIconSet可以包含开和关两套图标了。

为了方便移植，这个函数将忽略on参数并且返回iconSet属性。如果你依赖于on参数，你也许要把你的代码升级到QIconSet开/关机制了。

也可以参考iconSet和QIconSet::State。

void QToolButton::setOffIconSet ( constQIconSet& )

设置当按钮在“关”状态下被使用的图标集。详细情况请参考“offIconSet”属性。

void QToolButton::setOn ( boolenable ) [虚 槽]

设置按钮是否为开为enable。详细情况请参考“on”属性。

void QToolButton::setOnIconSet ( constQIconSet& )

设置当按钮在“开”状态下被使用的图标集。详细情况请参考“onIconSet”属性。

void QToolButton::setPopup ( QPopupMenu*popup )

把弹出菜单popup和这个工具按钮关联起来。

每次在工具按钮被按下一定时间之后，弹出菜单将被显示。一个经典的实例是一些网页浏览器的工具条上的“后退”按钮。如果用户点击它，浏览器简单地后退浏览到上一页。如果用户按下这个按钮一段时间，工具按钮会显示一个包含当前历史列表的菜单。

弹出菜单的所有权不会被传递给工具按钮。

也可以参考popup()。

void QToolButton::setPopupDelay ( intdelay )

设置在按下按钮和出现关联的弹出按钮之间的以毫秒为单位的时间。详细情况请参考“popupDelay”属性。

void QToolButton::setTextLabel ( constQString& ) [槽]

设置按钮的标签。详细情况请参考“textLabel”属性。

void QToolButton::setTextLabel ( constQString&newLabel, booltipToo ) [虚 槽]

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

设置按钮的标签为newLabel并且如果tipToo为真，自动地把工具提示也设置为newLabel。

void QToolButton::setToggleButton ( boolenable ) [虚 槽]

设置工具按钮是否是切换按钮为enable。详细情况请参考“toggleButton”属性。

void QToolButton::setUsesBigPixmap ( boolenable ) [虚 槽]

设置工具按钮是否使用大的像素映射为enable。详细情况请参考“usesBigPixmap”属性。

void QToolButton::setUsesTextLabel ( boolenable ) [虚 槽]

设置工具按钮是否在按钮像素映射下方显示标签为enable。详细情况请参考“usesTextLabel”属性。

QString QToolButton::textLabel () const

返回按钮的标签。详细情况请参考“textLabel”属性。

void QToolButton::toggle () [槽]

切换工具按钮的状态。

这个函数对于非切换按钮无效。

也可以参考toggleButton和toggled()。

bool QToolButton::uses3D () const [保护]

如果这个按钮应该被使用浮起的边缘绘制，返回真，否则返回假。

也可以参考drawButton()。

bool QToolButton::usesBigPixmap () const

如果工具按钮使用大地像素映射，返回真，否则返回假。详细情况请参考“usesBigPixmap”属性。

bool QToolButton::usesTextLabel () const

如果工具按钮在按钮像素映射下方显示标签，返回真，否则返回假。详细情况请参考“usesTextLabel”属性。

---

属性文档

bool autoRaise

这个属性保存的是自动浮起是否生效。

默认是失效的（也就是假）。

通过setAutoRaise()设置属性值并且通过autoRaise()来获得属性值。

QIconSet iconSet

这个属性保存的是提供显示在按钮上的图标的图标集。

设置这个属性把QToolButton::pixmap设置为零像素映射。没有默认图标集。

也可以参考pixmap、toggleButton和on。

通过setIconSet()设置属性值并且通过iconSet()来获得属性值。

QIconSet offIconSet

这个属性保存的是当按钮在“关”状态时使用的图标集。

这个函数是废弃的。它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

从Qt 3.0开始，QIconSet可以包含开和关两套图标了。现在QToolButton::iconSet属性替换了QToolButton::onIconSet和QToolButton::offIconSet。

为了方便移植，这个函数将忽略on参数并且返回iconSet属性。如果你依赖于on参数，你也许要把你的代码升级到QIconSet开/关机制了。

也可以参考iconSet和QIconSet::State。

通过setOffIconSet()设置属性值并且通过offIconSet()来获得属性值。

bool on

这个属性保存的是工具按钮是否为开。

这个属性对于非切换按钮无效。默认为假（也就是关）。

也可以参考toggleButton和toggle()。

通过setOn()设置属性值。

QIconSet onIconSet

这个属性保存的是当按钮在“开”状态时使用的图标集。

这个函数是废弃的。它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

从Qt 3.0开始，QIconSet可以包含开和关两套图标了。现在QToolButton::iconSet属性替换了QToolButton::onIconSet和QToolButton::offIconSet。

为了方便移植，这个函数将忽略on参数并且返回iconSet属性。如果你依赖于on参数，你也许要把你的代码升级到QIconSet开/关机制了。

也可以参考iconSet和QIconSet::State。

通过setOnIconSet()设置属性值并且通过onIconSet()来获得属性值。

int popupDelay

这个属性保存的是在按下按钮和出现关联的弹出按钮之间的以毫秒为单位的时间。

通常是在半秒左右。0值可以为工具按钮设置一个特殊区域来打开弹出菜单。

也可以参考setPopup()。

通过setPopupDelay()设置属性值并且通过popupDelay()来获得属性值。

QString textLabel

这个属性保存的是按钮的标签。

设置这个属性会自动地设置这个文本为工具提示。

通过setTextLabel()设置属性值并且通过textLabel()来获得属性值。

bool toggleButton

这个属性保存的是工具按钮是否是切换按钮。

切换按钮像检查框一样也有开/关状态。默认情况下，工具按钮不是切换按钮。

也可以参考on和toggle()。

通过setToggleButton()设置属性值。

bool usesBigPixmap

这个属性保存的是工具按钮是否使用大的像素映射。

QToolButton自动地链接这个属性到它所在的QMainWindow中的相应信号。我们强烈建议你使用QMainWindow::setUsesBigPixmaps()来替代它。

这个属性默认为真。

警告： 如果你设置一些按钮（在QMainWindow中）使用大的像素映射并且其它的使用小的像素映射，QMainWindow可能不能得到正确的几何形状。

通过setUsesBigPixmap()设置属性值并且通过usesBigPixmap()来获得属性值。

bool usesTextLabel

这个属性保存的是工具按钮是否在按钮像素映射下方显示标签。

默认为假。

QToolButton自动地链接这个槽到它所在的QMainWindow中的相应信号。

通过setUsesTextLabel()设置属性值并且通过usesTextLabel()来获得属性值。