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.

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

Public Slots

void setTextPosition ( QToolButton::TextPosition pos )
void setUsesBigPixmap ( bool enable )
void setUsesTextLabel ( bool enable )

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.

ConstantValueDescription
QToolButton::BesideIcon0The text appears beside the icon.
QToolButton::BelowIcon1The 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().