| 主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数 | |
QToolButton类提供了用于命令或者选项的可以快速访问的按钮，通常可以用在QToolBar里面。 详情请见……
#include <qtoolbutton.h>
继承了QButton。
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、图形用户界面设计手册：推动按钮和基本窗口部件。
工具按钮将显示iconSet，它的文本标签和工具提示设置为textLabel并且它的状态条信息设置为grouptext。它将被连接到receiver对象的slot槽。
箭头按钮的自动重复默认是打开的。
parent和name参数被发送给QWidget构造函数。
如果自动浮起有效，返回真，否则返回假。详细情况请参考“autoRaise”属性。
返回提供显示在按钮上的图标的图标集。详细情况请参考“iconSet”属性。
这个函数是废弃的。它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
从Qt 3.0开始，QIconSet可以包含开和关两套图标了。
为了方便移植，这个函数将忽略on参数并且返回iconSet属性。如果你依赖于on参数，你也许要把你的代码升级到QIconSet开/关机制了。
返回当按钮在“关”状态下被使用的图标集。详细情况请参考“offIconSet”属性。
返回当按钮在“开”状态下被使用的图标集。详细情况请参考“onIconSet”属性。
也可以参考setPopup()。
返回在按下按钮和出现关联的弹出按钮之间的以毫秒为单位的时间。详细情况请参考“popupDelay”属性。
设置自动浮起是否有效为enable。详细情况请参考“autoRaise”属性。
设置提供显示在按钮上的图标的图标集。详细情况请参考“iconSet”属性。
这个函数是废弃的。它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
从Qt 3.0开始，QIconSet可以包含开和关两套图标了。
为了方便移植，这个函数将忽略on参数并且返回iconSet属性。如果你依赖于on参数，你也许要把你的代码升级到QIconSet开/关机制了。
也可以参考iconSet和QIconSet::State。
设置当按钮在“关”状态下被使用的图标集。详细情况请参考“offIconSet”属性。
设置按钮是否为开为enable。详细情况请参考“on”属性。
设置当按钮在“开”状态下被使用的图标集。详细情况请参考“onIconSet”属性。
每次在工具按钮被按下一定时间之后，弹出菜单将被显示。一个经典的实例是一些网页浏览器的工具条上的“后退”按钮。如果用户点击它，浏览器简单地后退浏览到上一页。如果用户按下这个按钮一段时间，工具按钮会显示一个包含当前历史列表的菜单。
弹出菜单的所有权不会被传递给工具按钮。
也可以参考popup()。
设置在按下按钮和出现关联的弹出按钮之间的以毫秒为单位的时间。详细情况请参考“popupDelay”属性。
设置按钮的标签。详细情况请参考“textLabel”属性。
设置按钮的标签为newLabel并且如果tipToo为真，自动地把工具提示也设置为newLabel。
设置工具按钮是否是切换按钮为enable。详细情况请参考“toggleButton”属性。
设置工具按钮是否使用大的像素映射为enable。详细情况请参考“usesBigPixmap”属性。
设置工具按钮是否在按钮像素映射下方显示标签为enable。详细情况请参考“usesTextLabel”属性。
返回按钮的标签。详细情况请参考“textLabel”属性。
这个函数对于非切换按钮无效。
也可以参考toggleButton和toggled()。
也可以参考drawButton()。
如果工具按钮使用大地像素映射，返回真，否则返回假。详细情况请参考“usesBigPixmap”属性。
如果工具按钮在按钮像素映射下方显示标签，返回真，否则返回假。详细情况请参考“usesTextLabel”属性。
这个属性保存的是自动浮起是否生效。
默认是失效的（也就是假）。
通过setAutoRaise()设置属性值并且通过autoRaise()来获得属性值。
这个属性保存的是提供显示在按钮上的图标的图标集。
设置这个属性把QToolButton::pixmap设置为零像素映射。没有默认图标集。
也可以参考pixmap、toggleButton和on。
通过setIconSet()设置属性值并且通过iconSet()来获得属性值。
这个属性保存的是当按钮在“关”状态时使用的图标集。
这个函数是废弃的。它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
从Qt 3.0开始，QIconSet可以包含开和关两套图标了。现在QToolButton::iconSet属性替换了QToolButton::onIconSet和QToolButton::offIconSet。
为了方便移植，这个函数将忽略on参数并且返回iconSet属性。如果你依赖于on参数，你也许要把你的代码升级到QIconSet开/关机制了。
也可以参考iconSet和QIconSet::State。
通过setOffIconSet()设置属性值并且通过offIconSet()来获得属性值。
这个属性保存的是工具按钮是否为开。
这个属性对于非切换按钮无效。默认为假（也就是关）。
也可以参考toggleButton和toggle()。
通过setOn()设置属性值。
这个属性保存的是当按钮在“开”状态时使用的图标集。
这个函数是废弃的。它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
从Qt 3.0开始，QIconSet可以包含开和关两套图标了。现在QToolButton::iconSet属性替换了QToolButton::onIconSet和QToolButton::offIconSet。
为了方便移植，这个函数将忽略on参数并且返回iconSet属性。如果你依赖于on参数，你也许要把你的代码升级到QIconSet开/关机制了。
也可以参考iconSet和QIconSet::State。
通过setOnIconSet()设置属性值并且通过onIconSet()来获得属性值。
这个属性保存的是在按下按钮和出现关联的弹出按钮之间的以毫秒为单位的时间。
通常是在半秒左右。0值可以为工具按钮设置一个特殊区域来打开弹出菜单。
也可以参考setPopup()。
通过setPopupDelay()设置属性值并且通过popupDelay()来获得属性值。
这个属性保存的是按钮的标签。
设置这个属性会自动地设置这个文本为工具提示。
通过setTextLabel()设置属性值并且通过textLabel()来获得属性值。
这个属性保存的是工具按钮是否是切换按钮。
切换按钮像检查框一样也有开/关状态。默认情况下，工具按钮不是切换按钮。
通过setToggleButton()设置属性值。
这个属性保存的是工具按钮是否使用大的像素映射。
QToolButton自动地链接这个属性到它所在的QMainWindow中的相应信号。我们强烈建议你使用QMainWindow::setUsesBigPixmaps()来替代它。
这个属性默认为真。
警告： 如果你设置一些按钮（在QMainWindow中）使用大的像素映射并且其它的使用小的像素映射，QMainWindow可能不能得到正确的几何形状。
通过setUsesBigPixmap()设置属性值并且通过usesBigPixmap()来获得属性值。
这个属性保存的是工具按钮是否在按钮像素映射下方显示标签。
默认为假。
QToolButton自动地链接这个槽到它所在的QMainWindow中的相应信号。
通过setUsesTextLabel()设置属性值并且通过usesTextLabel()来获得属性值。
这个文件是Qt工具包一部分。 版权所有 © 1995-2002 Trolltech。保留所有权利。
| Copyright © 2002 Trolltech | Trademarks | 译者:Cavendish | Qt 3.0.5版
|