• Skip to content
  • Skip to link menu
  • KDE API Reference
  • kdelibs-4.14.38 API Reference
  • KDE Home
  • Contact Us
 

Plasma

  • plasma
  • widgets
toolbutton.h
Go to the documentation of this file.
1/*
2 * Copyright 2008 Marco Martin <notmart@gmail.com>
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU Library General Public License as
6 * published by the Free Software Foundation; either version 2, or
7 * (at your option) any later version.
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details
13 *
14 * You should have received a copy of the GNU Library General Public
15 * License along with this program; if not, write to the
16 * Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 */
19
20#ifndef PLASMA_TOOLBUTTON_H
21#define PLASMA_TOOLBUTTON_H
22
23#include <QtGui/QGraphicsProxyWidget>
24
25class QToolButton;
26
27#include <plasma/plasma_export.h>
28
29namespace Plasma
30{
31
32class ToolButtonPrivate;
33
39class PLASMA_EXPORT ToolButton : public QGraphicsProxyWidget
40{
41 Q_OBJECT
42
43 Q_PROPERTY(QGraphicsWidget *parentWidget READ parentWidget)
44 Q_PROPERTY(QString text READ text WRITE setText)
45 Q_PROPERTY(bool autoRaise READ autoRaise WRITE setAutoRaise)
46 Q_PROPERTY(QString image READ image WRITE setImage)
47 Q_PROPERTY(QString styleSheet READ styleSheet WRITE setStyleSheet)
48 Q_PROPERTY(QToolButton *nativeWidget READ nativeWidget)
49 Q_PROPERTY(QAction *action READ action WRITE setAction)
50 Q_PROPERTY(bool down READ isDown WRITE setDown)
51
52 Q_PROPERTY(qreal animationUpdate READ animationUpdate WRITE setAnimationUpdate)
53
54public:
55 explicit ToolButton(QGraphicsWidget *parent = 0);
56 ~ToolButton();
57
63 void setAutoRaise(bool raise);
64
68 bool autoRaise() const;
69
75 void setText(const QString &text);
76
80 QString text() const;
81
87 void setImage(const QString &path);
88
97 void setImage(const QString &path, const QString &elementid);
98
102 QString image() const;
103
110 void setDown(bool down);
111
116 bool isDown() const;
117
123 void setStyleSheet(const QString &stylesheet);
124
128 QString styleSheet();
129
137 void setAction(QAction *action);
138
144 QAction *action() const;
145
153 void setIcon(const QIcon &icon);
154
160 QIcon icon() const;
161
165 QToolButton *nativeWidget() const;
166
167Q_SIGNALS:
168 void clicked();
172 void pressed();
176 void released();
177
178protected:
179 void paint(QPainter *painter,
180 const QStyleOptionGraphicsItem *option,
181 QWidget *widget = 0);
182 void resizeEvent(QGraphicsSceneResizeEvent *event);
183 void hoverEnterEvent(QGraphicsSceneHoverEvent *event);
184 void hoverLeaveEvent(QGraphicsSceneHoverEvent *event);
185 void changeEvent(QEvent *event);
186 QVariant itemChange(GraphicsItemChange change, const QVariant &value);
187 QSizeF sizeHint(Qt::SizeHint which, const QSizeF & constraint) const;
188
189private Q_SLOTS:
190 void setAnimationUpdate(qreal progress);
191 qreal animationUpdate() const;
192
193private:
194 Q_PRIVATE_SLOT(d, void syncBorders())
195 Q_PRIVATE_SLOT(d, void syncToAction())
196 Q_PRIVATE_SLOT(d, void clearAction())
197 Q_PRIVATE_SLOT(d, void setPixmap())
198 Q_PRIVATE_SLOT(d, void setPalette())
199
200 friend class ToolButtonPrivate;
201 ToolButtonPrivate *const d;
202};
203
204} // namespace Plasma
205
206#endif // multiple inclusion guard
Plasma::ToolButton::clicked
void clicked()
Plasma::ToolButton::sizeHint
QSizeF sizeHint(Qt::SizeHint which, const QSizeF &constraint) const
Definition toolbutton.cpp:450
Plasma::ToolButton::resizeEvent
void resizeEvent(QGraphicsSceneResizeEvent *event)
Definition toolbutton.cpp:306
Plasma::ToolButton::isDown
bool isDown() const
Definition toolbutton.cpp:286
Plasma::ToolButton::setIcon
void setIcon(const QIcon &icon)
sets the icon for this toolbutton
Definition toolbutton.cpp:266
Plasma::ToolButton::nativeWidget
QToolButton * nativeWidget
Definition toolbutton.h:48
Plasma::ToolButton::setImage
void setImage(const QString &path)
Sets the path to an image to display.
Definition toolbutton.cpp:232
Plasma::ToolButton::itemChange
QVariant itemChange(GraphicsItemChange change, const QVariant &value)
Definition toolbutton.cpp:439
Plasma::ToolButton::ToolButtonPrivate
friend class ToolButtonPrivate
Definition toolbutton.h:200
Plasma::ToolButton::parentWidget
QGraphicsWidget * parentWidget
Definition toolbutton.h:43
Plasma::ToolButton::setAutoRaise
void setAutoRaise(bool raise)
Sets if the toolbutton has an autoraise behaviour.
Definition toolbutton.cpp:211
Plasma::ToolButton::paint
void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget=0)
Definition toolbutton.cpp:329
Plasma::ToolButton::image
QString image
Definition toolbutton.h:46
Plasma::ToolButton::setAction
void setAction(QAction *action)
Associate an action with this IconWidget this makes the button follow the state of the action,...
Definition toolbutton.cpp:201
Plasma::ToolButton::setText
void setText(const QString &text)
Sets the display text for this ToolButton.
Definition toolbutton.cpp:221
Plasma::ToolButton::animationUpdate
qreal animationUpdate
Definition toolbutton.h:52
Plasma::ToolButton::pressed
void pressed()
Plasma::ToolButton::ToolButton
ToolButton(QGraphicsWidget *parent=0)
Definition toolbutton.cpp:156
Plasma::ToolButton::icon
QIcon icon() const
Definition toolbutton.cpp:271
Plasma::ToolButton::changeEvent
void changeEvent(QEvent *event)
Definition toolbutton.cpp:428
Plasma::ToolButton::action
QAction * action
Definition toolbutton.h:49
Plasma::ToolButton::setDown
void setDown(bool down)
Sets the status of the button to pressed.
Definition toolbutton.cpp:281
Plasma::ToolButton::down
bool down
Definition toolbutton.h:50
Plasma::ToolButton::hoverEnterEvent
void hoverEnterEvent(QGraphicsSceneHoverEvent *event)
Definition toolbutton.cpp:385
Plasma::ToolButton::autoRaise
bool autoRaise
Definition toolbutton.h:45
Plasma::ToolButton::released
void released()
Plasma::ToolButton::styleSheet
QString styleSheet
Definition toolbutton.h:47
Plasma::ToolButton::text
QString text
Definition toolbutton.h:44
Plasma::ToolButton::setStyleSheet
void setStyleSheet(const QString &stylesheet)
Sets the stylesheet used to control the visual display of this ToolButton.
Definition toolbutton.cpp:291
Plasma::ToolButton::hoverLeaveEvent
void hoverLeaveEvent(QGraphicsSceneHoverEvent *event)
Definition toolbutton.cpp:406
QGraphicsProxyWidget
QGraphicsWidget
QStyleOptionGraphicsItem
QWidget
Plasma
Namespace for everything in libplasma.
Definition abstractdialogmanager.cpp:25
plasma_export.h
This file is part of the KDE documentation.
Documentation copyright © 1996-2025 The KDE developers.
Generated on Tue Mar 25 2025 00:00:00 by doxygen 1.14.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

Plasma

Skip menu "Plasma"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members
  • Related Pages

kdelibs-4.14.38 API Reference

Skip menu "kdelibs-4.14.38 API Reference"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDEWebKit
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • KPty
  • Kross
  • KUnitConversion
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal