Rename setters to be more Qt-like
[quassel.git] / src / uisupport / multilineedit.h
1 /***************************************************************************
2  *   Copyright (C) 2005-09 by the Quassel Project                          *
3  *   devel@quassel-irc.org                                                 *
4  *                                                                         *
5  *   This program is free software; you can redistribute it and/or modify  *
6  *   it under the terms of the GNU General Public License as published by  *
7  *   the Free Software Foundation; either version 2 of the License, or     *
8  *   (at your option) version 3.                                           *
9  *                                                                         *
10  *   This program is distributed in the hope that it will be useful,       *
11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
13  *   GNU General Public License for more details.                          *
14  *                                                                         *
15  *   You should have received a copy of the GNU General Public License     *
16  *   along with this program; if not, write to the                         *
17  *   Free Software Foundation, Inc.,                                       *
18  *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
19  ***************************************************************************/
20
21 #ifndef MULTILINEEDIT_H_
22 #define MULTILINEEDIT_H_
23
24 #include <QKeyEvent>
25 #include <QHash>
26 #include <QTextEdit>
27
28 #ifdef HAVE_KDE
29 #  include <KDE/KTextEdit>
30 #endif
31
32 class QKeyEvent;
33 class TabCompleter;
34
35 class MultiLineEdit : public
36 #ifdef HAVE_KDE
37                   KTextEdit
38 #else
39                   QTextEdit
40 #endif
41 {
42   Q_OBJECT
43
44 public:
45   enum Mode {
46     SingleLine,
47     MultiLine
48   };
49
50   MultiLineEdit(QWidget *parent = 0);
51   ~MultiLineEdit();
52
53   void setCustomFont(const QFont &); // should be used instead setFont(), so we can set our size correctly
54
55   // Compatibility methods with the rest of the classes which still expect this to be a QLineEdit
56   inline QString text() { return toPlainText(); }
57   inline int cursorPosition() { return textCursor().position(); }
58   inline void insert(const QString &newText) { insertPlainText(newText); }
59   inline void backspace() { keyPressEvent(new QKeyEvent(QEvent::KeyPress, Qt::Key_Backspace, Qt::NoModifier)); }
60   inline bool hasSelectedText() { return textCursor().hasSelection(); }
61   inline bool isSingleLine() const { return _singleLine; }
62
63   virtual QSize sizeHint() const;
64   virtual QSize minimumSizeHint() const;
65
66 public slots:
67   void setMode(Mode mode);
68   void setMinHeight(int numLines);
69   void setMaxHeight(int numLines);
70   void setScrollBarsEnabled(bool enable = true);
71   void setSpellCheckEnabled(bool enable = true);
72
73   // Note: Enabling wrap will make isSingleLine() not work correctly, so only use this if minHeight() > 1!
74   void setWordWrapEnabled(bool enable = true);
75
76 signals:
77   void textEntered(const QString &text);
78
79 protected:
80   virtual void keyPressEvent(QKeyEvent * event);
81   virtual void resizeEvent(QResizeEvent *event);
82
83 private slots:
84   void on_returnPressed();
85   void on_textChanged();
86   void on_documentHeightChanged(qreal height);
87
88   bool addToHistory(const QString &text, bool temporary = false);
89   void historyMoveForward();
90   void historyMoveBack();
91
92 private:
93   QStringList history;
94   QHash<int, QString> tempHistory;
95   qint32 idx;
96   Mode _mode;
97   bool _singleLine;
98   int _minHeight;
99   int _maxHeight;
100   bool _scrollBarsEnabled;
101
102   QSize _sizeHint;
103   qreal _lastDocumentHeight;
104
105   void reset();
106   void showHistoryEntry();
107   void updateScrollBars();
108   void computeSizeHint();
109 };
110
111 #endif