← Back to branch summary

~oif-team/ubuntu/natty/qt4-x11/xi2.1

« back to all changes in this revision

Viewing changes to src/gui/widgets/qtextedit.h

  • Committer: Bazaar Package Importer
  • Author(s): Adam Conrad
  • Date: 2005-08-24 04:09:09 UTC
  • Revision ID: james.westby@ubuntu.com-20050824040909-xmxe9jfr4a0w5671
Tags: upstream-4.0.0
Import upstream version 4.0.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/gui/widgets/qtextedit.h
 
1
/****************************************************************************
 
2
**
 
3
** Copyright (C) 1992-2005 Trolltech AS. All rights reserved.
 
4
**
 
5
** This file is part of the widgets module of the Qt Toolkit.
 
6
**
 
7
** This file may be distributed under the terms of the Q Public License
 
8
** as defined by Trolltech AS of Norway and appearing in the file
 
9
** LICENSE.QPL included in the packaging of this file.
 
10
**
 
11
** This file may be distributed and/or modified under the terms of the
 
12
** GNU General Public License version 2 as published by the Free Software
 
13
** Foundation and appearing in the file LICENSE.GPL included in the
 
14
** packaging of this file.
 
15
**
 
16
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
 
17
**   information about Qt Commercial License Agreements.
 
18
** See http://www.trolltech.com/qpl/ for QPL licensing information.
 
19
** See http://www.trolltech.com/gpl/ for GPL licensing information.
 
20
**
 
21
** Contact info@trolltech.com if any conditions of this licensing are
 
22
** not clear to you.
 
23
**
 
24
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 
25
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 
26
**
 
27
****************************************************************************/
 
28
 
 
29
#ifndef QTEXTEDIT_H
 
30
#define QTEXTEDIT_H
 
31
 
 
32
#include <QtGui/qabstractscrollarea.h>
 
33
#include <QtGui/qtextdocument.h>
 
34
#include <QtGui/qtextoption.h>
 
35
 
 
36
#ifdef QT3_SUPPORT
 
37
#include <QtGui/qtextcursor.h>
 
38
#include <QtGui/qtextformat.h>
 
39
#include <QtGui/qtextobject.h>
 
40
#include <QtGui/qtextlayout.h>
 
41
#endif
 
42
 
 
43
class QTextCharFormat;
 
44
class QStyleSheet;
 
45
class QTextDocument;
 
46
class QTextCursor;
 
47
class QTextBlockFormat;
 
48
class QMenu;
 
49
class QTextEditPrivate;
 
50
class QMimeData;
 
51
 
 
52
class Q_GUI_EXPORT QTextEdit : public QAbstractScrollArea
 
53
{
 
54
    Q_OBJECT
 
55
    Q_DECLARE_PRIVATE(QTextEdit)
 
56
    Q_FLAGS(AutoFormatting)
 
57
    Q_ENUMS(LineWrapMode)
 
58
    Q_PROPERTY(AutoFormatting autoFormatting READ autoFormatting WRITE setAutoFormatting)
 
59
    Q_PROPERTY(bool tabChangesFocus READ tabChangesFocus WRITE setTabChangesFocus)
 
60
    Q_PROPERTY(QString documentTitle READ documentTitle WRITE setDocumentTitle)
 
61
    Q_PROPERTY(bool undoRedoEnabled READ isUndoRedoEnabled WRITE setUndoRedoEnabled)
 
62
    Q_PROPERTY(LineWrapMode lineWrapMode READ lineWrapMode WRITE setLineWrapMode)
 
63
    QDOC_PROPERTY(QTextOption::WrapMode wordWrapMode READ wordWrapMode WRITE setWordWrapMode)
 
64
    Q_PROPERTY(int lineWrapColumnOrWidth READ lineWrapColumnOrWidth WRITE setLineWrapColumnOrWidth)
 
65
    Q_PROPERTY(bool readOnly READ isReadOnly WRITE setReadOnly)
 
66
    Q_PROPERTY(QString html READ toHtml WRITE setHtml)
 
67
public:
 
68
    enum LineWrapMode {
 
69
        NoWrap,
 
70
        WidgetWidth,
 
71
        FixedPixelWidth,
 
72
        FixedColumnWidth
 
73
    };
 
74
 
 
75
    enum AutoFormattingFlag {
 
76
        AutoNone = 0,
 
77
        AutoBulletList = 0x00000001,
 
78
        AutoAll = 0xffffffff
 
79
    };
 
80
 
 
81
    Q_DECLARE_FLAGS(AutoFormatting, AutoFormattingFlag)
 
82
 
 
83
    enum CursorAction {
 
84
        MoveBackward,
 
85
        MoveForward,
 
86
        MoveWordBackward,
 
87
        MoveWordForward,
 
88
        MoveUp,
 
89
        MoveDown,
 
90
        MoveLineStart,
 
91
        MoveLineEnd,
 
92
        MoveHome,
 
93
        MoveEnd,
 
94
        MovePageUp,
 
95
        MovePageDown
 
96
#if defined(QT3_SUPPORT) && !defined(Q_MOC_RUN)
 
97
        ,
 
98
        MovePgUp = MovePageUp,
 
99
        MovePgDown = MovePageDown
 
100
#endif
 
101
    };
 
102
 
 
103
    explicit QTextEdit(QWidget *parent = 0);
 
104
    explicit QTextEdit(const QString &text, QWidget *parent = 0);
 
105
    virtual ~QTextEdit();
 
106
 
 
107
    void setDocument(QTextDocument *document);
 
108
    QTextDocument *document() const;
 
109
 
 
110
    void setTextCursor(const QTextCursor &cursor);
 
111
    QTextCursor textCursor() const;
 
112
 
 
113
    bool isReadOnly() const;
 
114
    void setReadOnly(bool ro);
 
115
 
 
116
    qreal fontPointSize() const;
 
117
    QString fontFamily() const;
 
118
    int fontWeight() const;
 
119
    bool fontUnderline() const;
 
120
    bool fontItalic() const;
 
121
    QColor textColor() const;
 
122
    QFont currentFont() const;
 
123
    Qt::Alignment alignment() const;
 
124
 
 
125
    void mergeCurrentCharFormat(const QTextCharFormat &modifier);
 
126
 
 
127
    void setCurrentCharFormat(const QTextCharFormat &format);
 
128
    QTextCharFormat currentCharFormat() const;
 
129
 
 
130
    AutoFormatting autoFormatting() const;
 
131
    void setAutoFormatting(AutoFormatting features);
 
132
 
 
133
    bool tabChangesFocus() const;
 
134
    void setTabChangesFocus(bool b);
 
135
 
 
136
    inline void setDocumentTitle(const QString &title)
 
137
    { document()->setMetaInformation(QTextDocument::DocumentTitle, title); }
 
138
    inline QString documentTitle() const
 
139
    { return document()->metaInformation(QTextDocument::DocumentTitle); }
 
140
 
 
141
    inline bool isUndoRedoEnabled() const
 
142
    { return document()->isUndoRedoEnabled(); }
 
143
    inline void setUndoRedoEnabled(bool enable)
 
144
    { document()->setUndoRedoEnabled(enable); }
 
145
 
 
146
    LineWrapMode lineWrapMode() const;
 
147
    void setLineWrapMode(LineWrapMode mode);
 
148
 
 
149
    int lineWrapColumnOrWidth() const;
 
150
    void setLineWrapColumnOrWidth(int w);
 
151
 
 
152
    QTextOption::WrapMode wordWrapMode() const;
 
153
    void setWordWrapMode(QTextOption::WrapMode policy);
 
154
 
 
155
    bool find(const QString &exp, QTextDocument::FindFlags options = 0);
 
156
 
 
157
    inline QString toPlainText() const
 
158
    { return document()->toPlainText(); }
 
159
    inline QString toHtml() const
 
160
    { return document()->toHtml(); }
 
161
 
 
162
    void append(const QString &text);
 
163
 
 
164
    void ensureCursorVisible();
 
165
 
 
166
    virtual QVariant loadResource(int type, const QUrl &name);
 
167
 
 
168
    QMenu *createStandardContextMenu();
 
169
 
 
170
    QTextCursor cursorForPosition(const QPoint &pos) const;
 
171
    QRect cursorRect(const QTextCursor &cursor) const;
 
172
    QRect cursorRect() const;
 
173
 
 
174
    QString anchorAt(const QPoint& pos) const;
 
175
 
 
176
public slots:
 
177
    void setFontPointSize(qreal s);
 
178
    void setFontFamily(const QString &fontFamily);
 
179
    void setFontWeight(int w);
 
180
    void setFontUnderline(bool b);
 
181
    void setFontItalic(bool b);
 
182
    void setTextColor(const QColor &c);
 
183
    void setCurrentFont(const QFont &f);
 
184
    void setAlignment(Qt::Alignment a);
 
185
 
 
186
    void setPlainText(const QString &text);
 
187
    void setHtml(const QString &text);
 
188
 
 
189
    void cut();
 
190
    void copy();
 
191
    void paste();
 
192
 
 
193
    void clear();
 
194
    void selectAll();
 
195
 
 
196
    void insertPlainText(const QString &text);
 
197
    void insertHtml(const QString &text);
 
198
 
 
199
    void scrollToAnchor(const QString &name);
 
200
 
 
201
    void zoomIn(int range = 1);
 
202
    void zoomOut(int range = 1);
 
203
 
 
204
signals:
 
205
    void textChanged();
 
206
    void undoAvailable(bool b);
 
207
    void redoAvailable(bool b);
 
208
    void currentCharFormatChanged(const QTextCharFormat &format);
 
209
    void copyAvailable(bool b);
 
210
    void selectionChanged();
 
211
    void cursorPositionChanged();
 
212
 
 
213
protected:
 
214
    virtual void timerEvent(QTimerEvent *e);
 
215
    virtual void keyPressEvent(QKeyEvent *e);
 
216
    virtual void resizeEvent(QResizeEvent *);
 
217
    virtual void paintEvent(QPaintEvent *e);
 
218
    virtual void mousePressEvent(QMouseEvent *e);
 
219
    virtual void mouseMoveEvent(QMouseEvent *e);
 
220
    virtual void mouseReleaseEvent(QMouseEvent *e);
 
221
    virtual void mouseDoubleClickEvent(QMouseEvent *e);
 
222
    virtual bool focusNextPrevChild(bool next);
 
223
    virtual void contextMenuEvent(QContextMenuEvent *e);
 
224
    virtual void dragEnterEvent(QDragEnterEvent *e);
 
225
    virtual void dragLeaveEvent(QDragLeaveEvent *e);
 
226
    virtual void dragMoveEvent(QDragMoveEvent *e);
 
227
    virtual void dropEvent(QDropEvent *e);
 
228
    virtual void focusInEvent(QFocusEvent *e);
 
229
    virtual void focusOutEvent(QFocusEvent *e);
 
230
    virtual void showEvent(QShowEvent *);
 
231
    virtual void changeEvent(QEvent *e);
 
232
    virtual void wheelEvent(QWheelEvent *e);
 
233
 
 
234
    virtual QMimeData *createMimeDataFromSelection() const;
 
235
    virtual bool canInsertFromMimeData(const QMimeData *source) const;
 
236
    virtual void insertFromMimeData(const QMimeData *source);
 
237
 
 
238
    virtual void inputMethodEvent(QInputMethodEvent *);
 
239
    QVariant inputMethodQuery(Qt::InputMethodQuery property) const;
 
240
 
 
241
    QTextEdit(QTextEditPrivate &dd, QWidget *parent);
 
242
 
 
243
#ifdef QT3_SUPPORT
 
244
signals:
 
245
    QT_MOC_COMPAT void currentFontChanged(const QFont &f);
 
246
    QT_MOC_COMPAT void currentColorChanged(const QColor &c);
 
247
 
 
248
public:
 
249
    QT3_SUPPORT_CONSTRUCTOR QTextEdit(QWidget *parent, const char *name);
 
250
    inline QT3_SUPPORT bool find(const QString &exp, bool cs, bool wo)
 
251
    {
 
252
        QTextDocument::FindFlags flags = 0;
 
253
        if (cs)
 
254
            flags |= QTextDocument::FindCaseSensitively;
 
255
        if (wo)
 
256
            flags |= QTextDocument::FindWholeWords;
 
257
        return find(exp, flags);
 
258
    }
 
259
 
 
260
    inline QT3_SUPPORT void sync() {}
 
261
 
 
262
    QT3_SUPPORT void moveCursor(CursorAction action, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor);
 
263
 
 
264
    enum KeyboardAction {
 
265
        ActionBackspace,
 
266
        ActionDelete,
 
267
        ActionReturn,
 
268
        ActionKill,
 
269
        ActionWordBackspace,
 
270
        ActionWordDelete
 
271
    };
 
272
 
 
273
    QT3_SUPPORT void doKeyboardAction(KeyboardAction action);
 
274
 
 
275
    QT3_SUPPORT void setText(const QString &text);
 
276
    QT3_SUPPORT QString text() const;
 
277
    QT3_SUPPORT void setTextFormat(Qt::TextFormat);
 
278
    QT3_SUPPORT Qt::TextFormat textFormat() const;
 
279
 
 
280
    inline QT3_SUPPORT void setBold(bool b) { setFontWeight(b ? QFont::Bold : QFont::Normal); }
 
281
    inline QT3_SUPPORT void setUnderline(bool b) { setFontUnderline(b); }
 
282
    inline QT3_SUPPORT void setItalic(bool i) { setFontItalic(i); }
 
283
    inline QT3_SUPPORT void setFamily(const QString &family) { setFontFamily(family); }
 
284
    inline QT3_SUPPORT void setPointSize(int size) { setFontPointSize(size); }
 
285
 
 
286
    inline QT3_SUPPORT bool italic() const { return fontItalic(); }
 
287
    inline QT3_SUPPORT bool bold() const { return fontWeight() >= QFont::Bold; }
 
288
    inline QT3_SUPPORT bool underline() const { return fontUnderline(); }
 
289
    inline QT3_SUPPORT QString family() const { return fontFamily(); }
 
290
    inline QT3_SUPPORT int pointSize() const { return (int)(fontPointSize()+0.5); }
 
291
 
 
292
    inline QT3_SUPPORT bool hasSelectedText() const
 
293
    { return textCursor().hasSelection(); }
 
294
    inline QT3_SUPPORT QString selectedText() const
 
295
    { return textCursor().selectedText(); }
 
296
 
 
297
    inline QT3_SUPPORT bool isUndoAvailable() const
 
298
    { return document()->isUndoAvailable(); }
 
299
    inline QT3_SUPPORT bool isRedoAvailable() const
 
300
    { return document()->isRedoAvailable(); }
 
301
 
 
302
    inline QT3_SUPPORT void insert(const QString &text)
 
303
    { insertPlainText(text); }
 
304
 
 
305
    inline QT3_SUPPORT bool isModified() const
 
306
    { return document()->isModified(); }
 
307
 
 
308
    inline QT3_SUPPORT QColor color() const
 
309
    { return textColor(); }
 
310
 
 
311
public slots:
 
312
    inline QT_MOC_COMPAT void setModified(bool m = true)
 
313
    { document()->setModified(m); }
 
314
    inline QT_MOC_COMPAT void undo() const
 
315
    { document()->undo(); }
 
316
    inline QT_MOC_COMPAT void redo() const
 
317
    { document()->redo(); }
 
318
 
 
319
    inline QT_MOC_COMPAT void setColor(const QColor &c)
 
320
    { setTextColor(c); }
 
321
 
 
322
#endif
 
323
 
 
324
private:
 
325
    Q_DISABLE_COPY(QTextEdit)
 
326
    Q_PRIVATE_SLOT(d_func(), void repaintContents(const QRectF &r))
 
327
    Q_PRIVATE_SLOT(d_func(), void updateCurrentCharFormatAndSelection())
 
328
    Q_PRIVATE_SLOT(d_func(), void adjustScrollbars())
 
329
    Q_PRIVATE_SLOT(d_func(), void emitCursorPosChanged(const QTextCursor &))
 
330
};
 
331
 
 
332
#endif // QTEXTEDIT_H