class KToolBarButton

# class KToolBarButton | A toolbar button. More...
Internal Use Only
Definition | `#include <ktoolbarbutton.h>`
Inherits | QToolButton (qt) [public ]
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

#### Public Methods

- KToolBarButton (const QString& icon, int id, QWidget *parent, const char *name=0L, const QString &txt=QString::null, KInstance *_instance = KGlobal::instance())
- KToolBarButton (const QPixmap& pixmap, int id, QWidget *parent, const char *name=0L, const QString &txt=QString::null)
- KToolBarButton (QWidget *parent=0L, const char *name=0L)
- ~KToolBarButton ()
- virtual void setPixmap (const QPixmap &pixmap)
- void setDefaultPixmap (const QPixmap& pixmap)
- void setDisabledPixmap (const QPixmap& pixmap)
- virtual void setText (const QString &text)
- virtual void setIcon (const QString &icon)
- virtual void setIcon ( const QPixmap &pixmap )
- virtual void setIconSet ( const QIconSet &iconset )
- void setIcon (const QString &icon, bool )
- void setDefaultIcon (const QString& icon)
- void setDisabledIcon (const QString& icon)
- void on (bool flag = true)
- void toggle ()
- void setToggle (bool toggle = true)
- QPopupMenu * popup ()
- void setPopup (QPopupMenu *p, bool toggle = false)
- void setDelayedPopup (QPopupMenu *p, bool toggle = false)
- void setRadio (bool f = true)
- void setNoStyle (bool no_style = true)

#### Public Slots

- void modeChange ()
- virtual void setTextLabel (const QString&, bool tipToo)

#### Signals

- void clicked (int)
- void doubleClicked (int)
- void pressed (int)
- void released (int)
- void toggled (int)
- void highlighted (int, bool)

#### Protected Methods

- void paletteChange (const QPalette &)
- void leaveEvent (QEvent *e)
- void enterEvent (QEvent *e)
- void drawButton (QPainter *p)
- bool eventFilter (QObject *o, QEvent *e)
- void showMenu ()
- QSize sizeHint () const
- QSize minimumSizeHint () const
- QSize minimumSize () const
- bool isRaised () const
- bool isActive () const
- int iconTextMode () const
- virtual void virtual_hook ( int id, void* data )

#### Protected Slots

- void slotClicked ()
- void slotPressed ()
- void slotReleased ()
- void slotToggled ()
- void slotDelayTimeout ()

## Detailed Description

A toolbar button. This is used internally by KToolBar, use the KToolBar methods instead.

KToolBarButton (const QString& icon, int id, QWidget *parent, const char *name=0L, const QString &txt=QString::null, KInstance *_instance = KGlobal::instance()) | ### KToolBarButton

Construct a button with an icon loaded by the button itself. This will trust the button to load the correct icon with the correct size.

Parameters:

icon | Name of icon to load (may be absolute or relative)
id | Id of this button
parent | This button's parent
name | This button's internal name
txt | This button's text (in a tooltip or otherwise)

KToolBarButton (const QPixmap& pixmap, int id, QWidget *parent, const char *name=0L, const QString &txt=QString::null) | ### KToolBarButton

Construct a button with an existing pixmap. It is not recommended that you use this as the internal icon loading code will almost always get it "right".

Parameters:

icon | Name of icon to load (may be absolute or relative)
id | Id of this button
parent | This button's parent
name | This button's internal name
txt | This button's text (in a tooltip or otherwise)

KToolBarButton (QWidget *parent=0L, const char *name=0L) | ### KToolBarButton

Construct a separator button

Parameters:

parent | This button's parent
name | This button's internal name

~KToolBarButton () | ### ~KToolBarButton

Standard destructor

void setPixmap (const QPixmap &pixmap) | ### setPixmap

[virtual]

Set the pixmap directly for this button. This pixmap should be the active one... the dimmed and disabled pixmaps are constructed based on this one. However, don't use this function unless you are positive that you don't want to use setIcon.

Parameters:

pixmap | The active pixmap

void setDefaultPixmap (const QPixmap& pixmap) | ### setDefaultPixmap

Force the button to use this pixmap as the default one rather then generating it using effects.

Parameters:

pixmap | The pixmap to use as the default (normal) one

void setDisabledPixmap (const QPixmap& pixmap) | ### setDisabledPixmap

Force the button to use this pixmap when disabled one rather then generating it using effects.

Parameters:

pixmap | The pixmap to use when disabled

void setText (const QString &text) | ### setText

[virtual]

Set the text for this button. The text will be either used as a tooltip (IconOnly) or will be along side the icon

Parameters:

text | The button (or tooltip) text

void setIcon (const QString &icon) | ### setIcon

[virtual]

Set the icon for this button. The icon will be loaded internally with the correct size. This function is preferred over setIconSet

Parameters:

icon | The name of the icon

void setIcon ( const QPixmap &pixmap ) | ### setIcon

[virtual]

void setIconSet ( const QIconSet &iconset ) | ### setIconSet

[virtual]

Set the pixmaps for this toolbar button from a QIconSet. If you call this you don't need to call any of the other methods that set icons or pixmaps.

Parameters:

iconset | The iconset to use

void setIcon (const QString &icon, bool ) | ### setIcon

Set the active icon for this button. The pixmap itself is loaded internally based on the icon size... .. the disabled and default pixmaps, however will only be constructed if generate is true. This function is preferred over setPixmap

Parameters:

icon | The name of the active icon
generate | If true, then the other icons are automagically generated from this one

void setDefaultIcon (const QString& icon) | ### setDefaultIcon

Force the button to use this icon as the default one rather then generating it using effects.

Parameters:

icon | The icon to use as the default (normal) one

void setDisabledIcon (const QString& icon) | ### setDisabledIcon

Force the button to use this icon when disabled one rather then generating it using effects.

Parameters:

icon | The icon to use when disabled

void on (bool flag = true) | ### on

Turn this button on or off

Parameters:

flag | true or false

void toggle () | ### toggle

Toggle this button

void setToggle (bool toggle = true) | ### setToggle

Turn this button into a toggle button or disable the toggle aspects of it. This does not toggle the button itself. Use toggle() for that.

Parameters:

toggle | true or false

QPopupMenu * popup () | ### popup

Return a pointer to this button's popup menu (if it exists)

void setPopup (QPopupMenu *p, bool toggle = false) | ### setPopup

Give this button a popup menu. There will not be a delay when you press the button. Use setDelayedPopup if you want that behavior. You can also make the popup-menu "sticky", i.e. visible until a selection is made or the mouse is clikced elsewhere, by simply setting the second argument to true. This "sticky" button feature allows you to make a selection without having to press and hold down the mouse while making a selection.

Parameters:

p | The new popup menu
toggle | if true, makes the button "sticky" (toggled)

void setDelayedPopup (QPopupMenu *p, bool toggle = false) | ### setDelayedPopup

Gives this button a delayed popup menu.

This function allows you to add a delayed popup menu to the button. The popup menu is then only displayed when the button is pressed and held down for about half a second. You can also make the popup-menu "sticky", i.e. visible until a selection is made or the mouse is clikced elsewhere, by simply setting the second argument to true. This "sticky" button feature allows you to make a selection without having to press and hold down the mouse while making a selection.

Parameters:

p | the new popup menu
toggle | if true, makes the button "sticky" (toggled)

void setRadio (bool f = true) | ### setRadio

Turn this button into a radio button

Parameters:

f | true or false

void setNoStyle (bool no_style = true) | ### setNoStyle

Toolbar buttons naturally will assume the global styles concerning icons, icons sizes, etc. You can use this function to explicitely turn this off, if you like.

Parameters:

no_style | Will disable styles if true

void clicked (int) | ### clicked

[signal]

void doubleClicked (int) | ### doubleClicked

[signal]

void pressed (int) | ### pressed

[signal]

void released (int) | ### released

[signal]

void toggled (int) | ### toggled

[signal]

void highlighted (int, bool) | ### highlighted

[signal]

void modeChange () | ### modeChange

[slot]

This slot should be called whenever the toolbar mode has potentially changed. This includes such events as text changing, orientation changing, etc.

void setTextLabel (const QString&, bool tipToo) | ### setTextLabel

[virtual slot]

Reimplemented from QToolButton.

void paletteChange (const QPalette &) | ### paletteChange

[protected]

void leaveEvent (QEvent *e) | ### leaveEvent

[protected]

void enterEvent (QEvent *e) | ### enterEvent

[protected]

void drawButton (QPainter *p) | ### drawButton

[protected]

bool eventFilter (QObject *o, QEvent *e) | ### eventFilter

[protected]

void showMenu () | ### showMenu

[protected]

QSize sizeHint () | ### sizeHint

[protected const]

QSize minimumSizeHint () | ### minimumSizeHint

[protected const]

QSize minimumSize () | ### minimumSize

[protected const]

bool isRaised () | ### isRaised

[protected const]

bool isActive () | ### isActive

[protected const]

int iconTextMode () | ### iconTextMode

[protected const]

void slotClicked () | ### slotClicked

[protected slots slot]

void slotPressed () | ### slotPressed

[protected slots slot]

void slotReleased () | ### slotReleased

[protected slots slot]

void slotToggled () | ### slotToggled

[protected slots slot]

void slotDelayTimeout () | ### slotDelayTimeout

[protected slots slot]

void virtual_hook ( int id, void* data ) | ### virtual_hook

[protected virtual]

Generated by: root on macppc.ports.openbsd.org on Sat Sep 6 10:36:37 2003, using kdoc 2.0a54.