|  | Home · All Classes · Main Classes · Annotated · Grouped Classes · Functions |

# Qt 3 Support Members for QToolButton

The following class members are part of the Qt 3 support layer. They are provided to help you port old code to Qt 4. We advise against using them in new code.

- QToolButton class reference

### Public Types

- enum TextPosition { BesideIcon, BelowIcon }

### Public Functions

- QToolButton ( QWidget * parent, const char * name )
- QToolButton ( Qt::ArrowType type, QWidget * parent, const char * name )
- QToolButton ( const QIcon & iconSet, const QString & textLabel, const QString & statusTip, QObject * receiver, const char * slot, QWidget * parent, const char * name = 0 )
- QIcon iconSet () const
- QIcon iconSet ( bool on ) const
- QIcon offIconSet () const
- QIcon onIconSet () const
- void openPopup ()
- QMenu * popup () const
- int popupDelay () const
- void setIconSet ( const QIcon & icon )
- void setIconSet ( const QIcon & set, bool on )
- void setOffIconSet ( const QIcon & set )
- void setOnIconSet ( const QIcon & set )
- void setPixmap ( const QPixmap & pixmap )
- void setPopup ( QMenu * popup )
- void setPopupDelay ( int delay )
- void setTextLabel ( const QString & text, bool tooltip = true )
- QString textLabel () const
- TextPosition textPosition () const
- bool usesBigPixmap () const
- bool usesTextLabel () const

- 9 public functions inherited from QAbstractButton
- 60 public functions inherited from QWidget
- 8 public functions inherited from QObject
- 8 public functions inherited from QPaintDevice

### Public Slots

- void setTextPosition ( TextPosition pos )
- void setUsesBigPixmap ( bool enable )
- void setUsesTextLabel ( bool enable )

- 1 public slot inherited from QAbstractButton
- 1 public slot inherited from QWidget

## Member Type Documentation

### enum QToolButton::TextPosition

This enum describes the position of the tool button's text label in relation to the tool button's icon.

Constant | Value | Description
--- | --- | ---
`QToolButton::BesideIcon` | `0` | The text appears beside the icon.
`QToolButton::BelowIcon` | `1` | The text appears below the icon.

## Member Function Documentation

### QToolButton::QToolButton ( QWidget * parent, const char * name )

Constructs an empty tool button called name, with parent parent.

### QToolButton::QToolButton ( Qt::ArrowType type, QWidget * parent, const char * name )

Constructs a tool button as an arrow button. The `Qt::ArrowType` type defines the arrow direction. Possible values are `Qt::LeftArrow`, `Qt::RightArrow`, `Qt::UpArrow` and `Qt::DownArrow`.

An arrow button has auto-repeat turned on by default.

The parent and name arguments are sent to the QWidget constructor.

### QToolButton::QToolButton ( const QIcon & iconSet, const QString & textLabel, const QString & statusTip, QObject * receiver, const char * slot, QWidget * parent, const char * name = 0 )

Constructs a tool button called name, that is a child of parent.

The tool button will display iconSet, with its text label and tool tip set to textLabel and its status bar message set to statusTip. It will be connected to the slot in object receiver.

### QIcon QToolButton::iconSet () const

Use icon() instead.

### QIcon QToolButton::iconSet ( bool on ) const

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Since Qt 3.0, QIcon contains both the On and Off icons.

For ease of porting, this function ignores the on parameter and returns the iconSet property. If you relied on the on parameter, you probably want to update your code to use the QIcon On/Off mechanism.

### QIcon QToolButton::offIconSet () const

Use icon() instead.

### QIcon QToolButton::onIconSet () const

Use icon() instead.

### void QToolButton::openPopup ()

Use showMenu() instead.

### QMenu * QToolButton::popup () const

Use menu() instead.

### int QToolButton::popupDelay () const

Use the style hint QStyle::SH_ToolButton_PopupDelay instead.

### void QToolButton::setIconSet ( const QIcon & icon )

Use setIcon() instead.

### void QToolButton::setIconSet ( const QIcon & set, bool on )

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Since Qt 3.0, QIcon contains both the On and Off icons.

For ease of porting, this function ignores the on parameter and sets the iconSet property. If you relied on the on parameter, you probably want to update your code to use the QIcon On/Off mechanism.

See also iconSet and QIcon::State.

### void QToolButton::setOffIconSet ( const QIcon & set )

Use setIcon() instead.

### void QToolButton::setOnIconSet ( const QIcon & set )

Use setIcon() instead.

### void QToolButton::setPixmap ( const QPixmap & pixmap )

Use setIcon(QIcon(pixmap)) instead.

### void QToolButton::setPopup ( QMenu * popup )

Use setMenu() instead.

### void QToolButton::setPopupDelay ( int delay )

Use the style hint QStyle::SH_ToolButton_PopupDelay instead.

### void QToolButton::setTextLabel ( const QString & text, bool tooltip = true )

Use setText() and setToolTip() instead.

### void QToolButton::setTextPosition ( TextPosition pos ) `[slot]`

Use setToolButtonStyle() instead.

### void QToolButton::setUsesBigPixmap ( bool enable ) `[slot]`

Use setIconSize() instead.

### void QToolButton::setUsesTextLabel ( bool enable ) `[slot]`

Use setToolButtonStyle() instead.

### QString QToolButton::textLabel () const

Use text() instead.

### TextPosition QToolButton::textPosition () const

Use toolButtonStyle() instead.

### bool QToolButton::usesBigPixmap () const

Use iconSize() instead.

### bool QToolButton::usesTextLabel () const

Use toolButtonStyle() instead.