KDE 4.7 PyKDE API Reference

- KDE's Python API

# ToolButton Class Reference

`from PyKDE4.plasma import *`

Inherits: QGraphicsProxyWidget → QGraphicsWidget → QObject
Namespace: Plasma

## Detailed Description

ToolButton plasma/widgets/pushbutton.h <Plasma/Widgets/ToolButton>

Provides a plasma-themed QToolButton.

## Signals

| clicked ()
| pressed ()
| released ()

## Methods

| __init__ (self, QGraphicsWidget parent=0)
QAction | action (self)
bool | autoRaise (self)
| changeEvent (self, QEvent event)
| hoverEnterEvent (self, QGraphicsSceneHoverEvent event)
| hoverLeaveEvent (self, QGraphicsSceneHoverEvent event)
QIcon | icon (self)
QString | image (self)
bool | isDown (self)
QVariant | itemChange (self, QGraphicsItem::GraphicsItemChange change, QVariant value)
QToolButton | nativeWidget (self)
| paint (self, QPainter painter, QStyleOptionGraphicsItem option, QWidget widget=0)
| resizeEvent (self, QGraphicsSceneResizeEvent event)
| setAction (self, QAction action)
| setAutoRaise (self, bool raise)
| setDown (self, bool down)
| setIcon (self, QIcon icon)
| setImage (self, QString path)
| setImage (self, QString path, QString elementid)
| setStyleSheet (self, QString stylesheet)
| setText (self, QString text)
QSizeF | sizeHint (self, Qt::SizeHint which, QSizeF constraint)
QString | styleSheet (self)
QString | text (self)

## Signal Documentation

clicked | ( |  | ) |

Signal syntax:
  `QObject.connect(source, SIGNAL("clicked()"), target_slot)`

pressed | ( |  | ) |

Since:
  4.4

Signal syntax:
  `QObject.connect(source, SIGNAL("pressed()"), target_slot)`

released | ( |  | ) |

Since:
  4.4

Signal syntax:
  `QObject.connect(source, SIGNAL("released()"), target_slot)`

## Method Documentation

__init__ | ( | self, |
|  | QGraphicsWidget | parent=0
| ) |  |  |

QAction action | ( |  | self ) |

Returns:
  the currently associated action, if any.

Since:
  4.3

bool autoRaise | ( |  | self ) |

Returns:
  true if the toolbutton has an autoraise behaviour

changeEvent | ( | self, |
|  | QEvent | event
| ) |  |  |

hoverEnterEvent | ( | self, |
|  | QGraphicsSceneHoverEvent | event
| ) |  |  |

hoverLeaveEvent | ( | self, |
|  | QGraphicsSceneHoverEvent | event
| ) |  |  |

QIcon icon | ( |  | self ) |

Returns:
  the icon of this button

Since:
  4.3

QString image | ( |  | self ) |

Returns:
  the image path being displayed currently, or an empty string if none.

bool isDown | ( |  | self ) |

Returns:
  true if the button is pressed down

Since:
  4.4

QVariant itemChange | ( | self, |
|  | QGraphicsItem::GraphicsItemChange | change,
|  | QVariant | value
| ) |  |  |

QToolButton nativeWidget | ( |  | self ) |

Returns:
  the native widget wrapped by this ToolButton

paint | ( | self, |
|  | QPainter | painter,
|  | QStyleOptionGraphicsItem | option,
|  | QWidget | widget=0
| ) |  |  |

resizeEvent | ( | self, |
|  | QGraphicsSceneResizeEvent | event
| ) |  |  |

setAction | ( | self, |
|  | QAction | action
| ) |  |  |

Associate an action with this IconWidget this makes the button follow the state of the action, using its icon, text, etc. when the button is clicked, it will also trigger the action.

Since:
  4.3

setAutoRaise | ( | self, |
|  | bool | raise
| ) |  |  |

Sets if the toolbutton has an autoraise behaviour

Parameters:

  | raise |

setDown | ( | self, |
|  | bool | down
| ) |  |  |

Sets the status of the button to pressed

Parameters:

  | down |

Since:
  4.5

setIcon | ( | self, |
|  | QIcon | icon
| ) |  |  |

sets the icon for this toolbutton

Parameters:

  | icon | the icon we want to use

Since:
  4.3

setImage | ( | self, |
|  | QString | path
| ) |  |  |

Sets the path to an svg image to display and the id of the used svg element, if necessary.

Parameters:

  | path | the path to the image; if a relative path, then a themed image will be loaded.
  | elementid | the id of a svg element.

Since:
  4.4

setImage | ( | self, |
|  | QString | path,
|  | QString | elementid
| ) |  |  |

Sets the path to an svg image to display and the id of the used svg element, if necessary.

Parameters:

  | path | the path to the image; if a relative path, then a themed image will be loaded.
  | elementid | the id of a svg element.

Since:
  4.4

setStyleSheet | ( | self, |
|  | QString | stylesheet
| ) |  |  |

Sets the stylesheet used to control the visual display of this ToolButton

Parameters:

  | stylesheet | a CSS string

setText | ( | self, |
|  | QString | text
| ) |  |  |

Sets the display text for this ToolButton

Parameters:

  | text | the text to display; should be translated.

QSizeF sizeHint | ( | self, |
|  | Qt::SizeHint | which,
|  | QSizeF | constraint
| ) |  |  |

QString styleSheet | ( |  | self ) |

Returns:
  the stylesheet currently used with this widget

QString text | ( |  | self ) |

Returns:
  the display text