1 /****************************************************************************
3 ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
4 ** All rights reserved.
5 ** Contact: Nokia Corporation (qt-info@nokia.com)
7 ** This file is part of the QtGui module of the Qt Toolkit.
9 ** $QT_BEGIN_LICENSE:LGPL$
10 ** GNU Lesser General Public License Usage
11 ** This file may be used under the terms of the GNU Lesser General Public
12 ** License version 2.1 as published by the Free Software Foundation and
13 ** appearing in the file LICENSE.LGPL included in the packaging of this
14 ** file. Please review the following information to ensure the GNU Lesser
15 ** General Public License version 2.1 requirements will be met:
16 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
18 ** In addition, as a special exception, Nokia gives you certain additional
19 ** rights. These rights are described in the Nokia Qt LGPL Exception
20 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
22 ** GNU General Public License Usage
23 ** Alternatively, this file may be used under the terms of the GNU General
24 ** Public License version 3.0 as published by the Free Software Foundation
25 ** and appearing in the file LICENSE.GPL included in the packaging of this
26 ** file. Please review the following information to ensure the GNU General
27 ** Public License version 3.0 requirements will be met:
28 ** http://www.gnu.org/copyleft/gpl.html.
31 ** Alternatively, this file may be used in accordance with the terms and
32 ** conditions contained in a signed written agreement between you and Nokia.
40 ****************************************************************************/
42 #ifndef QTEXTCONTROL_P_P_H
43 #define QTEXTCONTROL_P_P_H
49 // This file is not part of the Qt API. It exists purely as an
50 // implementation detail. This header file may change from version to
51 // version without notice, or even be removed.
56 #include "QtGui/qtextdocumentfragment.h"
57 #include "QtGui/qscrollbar.h"
58 #include "QtGui/qtextcursor.h"
59 #include "QtGui/qtextformat.h"
60 #include "QtGui/qmenu.h"
61 #include "QtGui/qabstracttextdocumentlayout.h"
62 #include "QtCore/qbasictimer.h"
63 #include "QtCore/qpointer.h"
64 #include "private/qobject_p.h"
69 class QAbstractScrollArea;
72 class QTextControlPrivate : public QObjectPrivate
74 Q_DECLARE_PUBLIC(QTextControl)
76 QTextControlPrivate();
78 bool cursorMoveKeyEvent(QKeyEvent *e);
80 void updateCurrentCharFormat();
85 void gotoNextTableCell();
86 void gotoPreviousTableCell();
88 void createAutoBulletList();
90 void init(Qt::TextFormat format = Qt::RichText, const QString &text = QString(),
91 QTextDocument *document = 0);
92 void setContent(Qt::TextFormat format = Qt::RichText, const QString &text = QString(),
93 QTextDocument *document = 0);
96 void paste(const QMimeData *source);
98 void setCursorPosition(const QPointF &pos);
99 void setCursorPosition(int pos, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor);
101 void repaintCursor();
102 inline void repaintSelection()
103 { repaintOldAndNewSelection(QTextCursor()); }
104 void repaintOldAndNewSelection(const QTextCursor &oldSelection);
106 void selectionChanged(bool forceEmitSelectionChanged = false);
108 void _q_updateCurrentCharFormatAndSelection();
110 #ifndef QT_NO_CLIPBOARD
111 void setClipboardSelection();
114 void _q_emitCursorPosChanged(const QTextCursor &someCursor);
116 void setBlinkingCursorEnabled(bool enable);
118 void extendWordwiseSelection(int suggestedNewPosition, qreal mouseXPosition);
119 void extendBlockwiseSelection(int suggestedNewPosition);
121 void _q_deleteSelected();
123 void _q_setCursorAfterUndoRedo(int undoPosition, int charsAdded, int charsRemoved);
125 QRectF cursorRectPlusUnicodeDirectionMarkers(const QTextCursor &cursor) const;
126 QRectF rectForPosition(int position) const;
127 QRectF selectionRect(const QTextCursor &cursor) const;
128 inline QRectF selectionRect() const
129 { return selectionRect(this->cursor); }
131 QString anchorForCursor(const QTextCursor &anchor) const;
133 void keyPressEvent(QKeyEvent *e);
134 void mousePressEvent(QEvent *e, Qt::MouseButton button, const QPointF &pos,
135 Qt::KeyboardModifiers modifiers,
136 Qt::MouseButtons buttons,
137 const QPoint &globalPos);
138 void mouseMoveEvent(QEvent *e, Qt::MouseButton button, const QPointF &pos,
139 Qt::KeyboardModifiers modifiers,
140 Qt::MouseButtons buttons,
141 const QPoint &globalPos);
142 void mouseReleaseEvent(QEvent *e, Qt::MouseButton button, const QPointF &pos,
143 Qt::KeyboardModifiers modifiers,
144 Qt::MouseButtons buttons,
145 const QPoint &globalPos);
146 void mouseDoubleClickEvent(QEvent *e, Qt::MouseButton button, const QPointF &pos,
147 Qt::KeyboardModifiers modifiers,
148 Qt::MouseButtons buttons,
149 const QPoint &globalPos);
150 bool sendMouseEventToInputContext(QEvent *e, QEvent::Type eventType, Qt::MouseButton button,
152 Qt::KeyboardModifiers modifiers,
153 Qt::MouseButtons buttons,
154 const QPoint &globalPos);
155 void contextMenuEvent(const QPoint &screenPos, const QPointF &docPos, QWidget *contextWidget);
156 void focusEvent(QFocusEvent *e);
157 #ifdef QT_KEYPAD_NAVIGATION
158 void editFocusEvent(QEvent *e);
160 bool dragEnterEvent(QEvent *e, const QMimeData *mimeData);
161 void dragLeaveEvent();
162 bool dragMoveEvent(QEvent *e, const QMimeData *mimeData, const QPointF &pos);
163 bool dropEvent(const QMimeData *mimeData, const QPointF &pos, Qt::DropAction dropAction, QWidget *source);
165 void inputMethodEvent(QInputMethodEvent *);
167 void activateLinkUnderCursor(QString href = QString());
169 #ifndef QT_NO_TOOLTIP
170 void showToolTip(const QPoint &globalPos, const QPointF &pos, QWidget *contextWidget);
173 void append(const QString &text, Qt::TextFormat format = Qt::AutoText);
175 QInputContext *inputContext();
180 bool cursorIsFocusIndicator;
181 QTextCharFormat lastCharFormat;
183 QTextCursor dndFeedbackCursor;
185 Qt::TextInteractionFlags interactionFlags;
187 QBasicTimer cursorBlinkTimer;
188 QBasicTimer trippleClickTimer;
189 QPointF trippleClickPoint;
197 QPointer<QWidget> contextWidget;
199 bool lastSelectionState;
201 bool ignoreAutomaticScrollbarAdjustement;
203 QTextCursor selectedWordOnDoubleClick;
204 QTextCursor selectedBlockOnTrippleClick;
210 bool hideCursor; // used to hide the cursor in the preedit area
212 QVector<QAbstractTextDocumentLayout::Selection> extraSelections;
216 #ifdef QT_KEYPAD_NAVIGATION
221 QString highlightedAnchor; // Anchor below cursor
222 QString anchorOnMousePress;
223 bool hadSelectionOnMousePress;
225 bool ignoreUnusedNavigationEvents;
226 bool openExternalLinks;
228 bool wordSelectionEnabled;
232 void _q_updateBlock(const QTextBlock &);
233 void _q_documentLayoutChanged();
238 #endif // QTEXTCONTROL_P_H