Qt Reference Documentation

# 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 & icon, 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 ( QToolButton::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 & icon, 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 the given icon, 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.

See also setIconSet().

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

This is an overloaded 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 icon 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.

See also setOffIconSet().

### QIcon QToolButton::onIconSet () const

Use icon() instead.

See also setOnIconSet().

### void QToolButton::openPopup ()

Use showMenu() instead.

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

Use menu() instead.

See also setPopup().

### int QToolButton::popupDelay () const

Use the style hint QStyle::SH_ToolButton_PopupDelay instead.

See also setPopupDelay().

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

Use setIcon() instead.

See also iconSet().

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

This is an overloaded 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 icon property. If you relied on the on parameter, you probably want to update your code to use the QIcon On/Off mechanism.

See also icon and QIcon::State.

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

Use setIcon() instead.

See also offIconSet().

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

Use setIcon() instead.

See also onIconSet().

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

Use setIcon(QIcon(pixmap)) instead.

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

Use setMenu() instead.

See also popup().

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

Use the style hint QStyle::SH_ToolButton_PopupDelay instead.

See also popupDelay().

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

Use setText() and setToolTip() instead.

See also textLabel().

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

Use setToolButtonStyle() instead.

See also textPosition().

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

Use setIconSize() instead.

See also usesBigPixmap().

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

Use setToolButtonStyle() instead.

See also usesTextLabel().

### QString QToolButton::textLabel () const

Use text() instead.

See also setTextLabel().

### TextPosition QToolButton::textPosition () const

Use toolButtonStyle() instead.

See also setTextPosition().

### bool QToolButton::usesBigPixmap () const

Use iconSize() instead.

See also setUsesBigPixmap().

### bool QToolButton::usesTextLabel () const

Use toolButtonStyle() instead.

See also setUsesTextLabel().