summaryrefslogtreecommitdiffstats
path: root/lib/kofficeui/KoToolBox.h
blob: 81e1c75128c5ab35986189cbb3915dc4222ce204 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
/*
   Copyright (c) 2005 Boudewijn Rempt <boud@valdyas.org>

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
 */
#ifndef _KO_TOOLBOX_H_
#define _KO_TOOLBOX_H_

#include <qtoolbutton.h>
#include <qptrvector.h>
#include <qtoolbar.h>
#include <koffice_export.h>
#include <ktoolbar.h>

class QWidget;
class KAction;
class KMainWindow;
class KDualColorButton;
class QGridLayout;
class ToolArea;


/**
 * KActionBox is a kind of super-specialized toolbox that can order
 * tools according to type and priority.
 *
 * This is to a large extent a port of the Karbon vtoolbox -- with
 * which it should be merged one day. However, it doesn't depend on a
 * tool-like class, it aggregates actions.
 */

class KOFFICEUI_EXPORT KoToolBox : public KToolBar {

    Q_OBJECT

public:

    KoToolBox( KMainWindow *mainWin, const char* name, KInstance* instance, int numberOfTooltypes);
    virtual ~KoToolBox();

    // Called by the toolcontroller for each tool. For every category,
    // there is a separate list, and the tool is categorized correctly.
    // The tool is not yet added to the widgets; call setupTools()
    // to do that. We don't store the tool.
    void registerTool(KAction * tool, int toolType, Q_UINT32 priority);

    // Called when all tools have been added by the tool controller
    void setupTools();

public slots:

    virtual void setOrientation ( Orientation o );
    void slotButtonPressed( int id );
    void slotPressButton( int id );

    // Enables or disables all buttons and the corresponding actions.
    void enableTools(bool enable);

    void slotSetTool(const QString & toolname);

private:

    QToolButton * createButton(QWidget * parent, const char* iconName, QString tooltip);


private:
    Q_UINT32 m_numberOfButtons;

    QButtonGroup * m_buttonGroup; // The invisible group of all toolbuttons, so only one can be active at a given time

    QPtrList<ToolArea> m_toolBoxes; // For every ToolArea

    typedef QMap< int, KAction*> ToolList; // The priority ordered list of tools for a certain tooltype

    QPtrList<ToolList> m_tools;
    QPtrList<KAction> m_idToActionMap; // Map the buttongroup id's to actions for easy activating.
    KInstance* m_instance;
};


class ToolArea : public QWidget {

public:
    ToolArea(QWidget *parent);
    ~ToolArea();

    void  setOrientation ( Qt::Orientation o );
    void  add(QWidget *button);

    QWidget* getNextParent();

private:
    QPtrList<QWidget>  m_children;
    QBoxLayout        *m_layout;

    QWidget           *m_leftRow;
    QBoxLayout        *m_leftLayout;

    QWidget           *m_rightRow;
    QBoxLayout        *m_rightLayout;

    bool               m_left;
};


#endif // _KO_TOOLBOX_H_