summaryrefslogtreecommitdiffstats
path: root/kolourpaint/widgets/kptoolwidgetbase.h
diff options
context:
space:
mode:
Diffstat (limited to 'kolourpaint/widgets/kptoolwidgetbase.h')
-rw-r--r--kolourpaint/widgets/kptoolwidgetbase.h112
1 files changed, 112 insertions, 0 deletions
diff --git a/kolourpaint/widgets/kptoolwidgetbase.h b/kolourpaint/widgets/kptoolwidgetbase.h
new file mode 100644
index 00000000..a23f9a16
--- /dev/null
+++ b/kolourpaint/widgets/kptoolwidgetbase.h
@@ -0,0 +1,112 @@
+
+/*
+ Copyright (c) 2003,2004,2005 Clarence Dang <dang@kde.org>
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+ IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+ IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+ INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+
+#ifndef __kp_tool_widget_base_h__
+#define __kp_tool_widget_base_h__
+
+#include <qframe.h>
+#include <qpair.h>
+#include <qpixmap.h>
+#include <qrect.h>
+#include <qvaluevector.h>
+#include <qwidget.h>
+
+
+class QPainter;
+
+
+// TODO: frame becomes a combobox when its parent kpToolToolBar becomes too small
+class kpToolWidgetBase : public QFrame
+{
+Q_OBJECT
+
+public:
+ kpToolWidgetBase (QWidget *parent, const char *name); // must provide a name for config to work
+ virtual ~kpToolWidgetBase ();
+
+public:
+ void addOption (const QPixmap &pixmap, const QString &toolTip = QString::null);
+ void startNewOptionRow ();
+
+ // Call this at the end of your constructor.
+ // If the default row & col could not be read from the config,
+ // <fallBackRow> & <fallBackCol> are passed to setSelected().
+ void finishConstruction (int fallBackRow, int fallBackCol);
+
+private:
+ QValueVector <int> spreadOutElements (const QValueVector <int> &sizes, int maxSize);
+
+public: // (only have to use these if you don't use finishConstruction())
+ // (rereads from config file)
+ QPair <int, int> defaultSelectedRowAndCol () const;
+ int defaultSelectedRow () const;
+ int defaultSelectedCol () const;
+
+ void saveSelectedAsDefault () const;
+
+ void relayoutOptions ();
+
+public:
+ int selectedRow () const;
+ int selectedCol () const;
+
+ int selected () const;
+
+ bool hasPreviousOption (int *row = 0, int *col = 0) const;
+ bool hasNextOption (int *row = 0, int *col = 0) const;
+
+public slots:
+ // (returns whether <row> and <col> were in range)
+ virtual bool setSelected (int row, int col, bool saveAsDefault);
+ bool setSelected (int row, int col);
+
+ bool selectPreviousOption ();
+ bool selectNextOption ();
+
+signals:
+ void optionSelected (int row, int col);
+
+protected:
+ virtual void mousePressEvent (QMouseEvent *e);
+ virtual void drawContents (QPainter *painter);
+
+ void setInvertSelectedPixmap (bool yes = true) { m_invertSelectedPixmap = yes; }
+ bool m_invertSelectedPixmap;
+
+ // coulbe be a QFrame or a ComboBox
+ QWidget *m_baseWidget;
+
+ QValueVector < QValueVector <QPixmap> > m_pixmaps;
+ QValueVector < QValueVector <QString> > m_toolTips;
+
+ QValueVector < QValueVector <QRect> > m_pixmapRects;
+
+ int m_selectedRow, m_selectedCol;
+};
+
+#endif // __kp_tool_widget_base_h__