/****************************************************************************

**

** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (qt-info@nokia.com)

**

** This file is part of the QtGui module of the Qt Toolkit.

**

** $QT_BEGIN_LICENSE:LGPL$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** GNU Lesser General Public License Usage

** Alternatively, this file may be used under the terms of the GNU Lesser

** General Public License version 2.1 as published by the Free Software

** Foundation and appearing in the file LICENSE.LGPL included in the

** packaging of this file.  Please review the following information to

** ensure the GNU Lesser General Public License version 2.1 requirements

** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

**

** In addition, as a special exception, Nokia gives you certain additional

** rights.  These rights are described in the Nokia Qt LGPL Exception

** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

****************************************************************************/

#ifndef QTEXTCONTROL_P_H

#define QTEXTCONTROL_P_H

//

//  W A R N I N G

//  -------------

//

// This file is not part of the Qt API.  It exists purely as an

// implementation detail.  This header file may change from version to

// version without notice, or even be removed.

//

// We mean it.

//

#include <QtGui/qtextdocument.h>

#include <QtGui/qtextoption.h>

#include <QtGui/qtextcursor.h>

#include <QtGui/qtextformat.h>

#include <QtGui/qtextedit.h>

#include <QtGui/qmenu.h>

#include <QtCore/qrect.h>

#include <QtGui/qabstracttextdocumentlayout.h>

#include <QtGui/qtextdocumentfragment.h>

#ifdef QT3_SUPPORT

#include <QtGui/qtextobject.h>

#include <QtGui/qtextlayout.h>

#endif

QT_BEGIN_HEADER

QT_BEGIN_NAMESPACE

QT_MODULE(Gui)

class QStyleSheet;

class QTextDocument;

class QMenu;

class QTextControlPrivate;

class QMimeData;

class QAbstractScrollArea;

class QEvent;

class QTimerEvent;

class Q_GUI_EXPORT QTextControl : public QObject

{

    Q_OBJECT

    Q_DECLARE_PRIVATE(QTextControl)

#ifndef QT_NO_TEXTHTMLPARSER

    Q_PROPERTY(QString html READ toHtml WRITE setHtml NOTIFY textChanged USER true)

#endif

    Q_PROPERTY(bool overwriteMode READ overwriteMode WRITE setOverwriteMode)

    Q_PROPERTY(bool acceptRichText READ acceptRichText WRITE setAcceptRichText)

    Q_PROPERTY(int cursorWidth READ cursorWidth WRITE setCursorWidth)

    Q_PROPERTY(Qt::TextInteractionFlags textInteractionFlags READ textInteractionFlags WRITE setTextInteractionFlags)

    Q_PROPERTY(bool openExternalLinks READ openExternalLinks WRITE setOpenExternalLinks)

public:

    explicit QTextControl(QObject *parent = 0);

    explicit QTextControl(const QString &text, QObject *parent = 0);

    explicit QTextControl(QTextDocument *doc, QObject *parent = 0);

    virtual ~QTextControl();

    void setDocument(QTextDocument *document);

    QTextDocument *document() const;

    void setTextCursor(const QTextCursor &cursor);

    QTextCursor textCursor() const;

    void setTextInteractionFlags(Qt::TextInteractionFlags flags);

    Qt::TextInteractionFlags textInteractionFlags() const;

    void mergeCurrentCharFormat(const QTextCharFormat &modifier);

    void setCurrentCharFormat(const QTextCharFormat &format);

    QTextCharFormat currentCharFormat() const;

    bool find(const QString &exp, QTextDocument::FindFlags options = 0);

    inline QString toPlainText() const

    { return document()->toPlainText(); }

#ifndef QT_NO_TEXTHTMLPARSER

    inline QString toHtml() const

    { return document()->toHtml(); }

#endif

    virtual void ensureCursorVisible();

    virtual QVariant loadResource(int type, const QUrl &name);

#ifndef QT_NO_CONTEXTMENU

    QMenu *createStandardContextMenu(const QPointF &pos, QWidget *parent);

#endif

    QTextCursor cursorForPosition(const QPointF &pos) const;

    QRectF cursorRect(const QTextCursor &cursor) const;

    QRectF cursorRect() const;

    QRectF selectionRect(const QTextCursor &cursor) const;

    QRectF selectionRect() const;

    QString anchorAt(const QPointF &pos) const;

    QPointF anchorPosition(const QString &name) const;

    QString anchorAtCursor() const;

    bool overwriteMode() const;

    void setOverwriteMode(bool overwrite);

    int cursorWidth() const;

    void setCursorWidth(int width);

    bool acceptRichText() const;

    void setAcceptRichText(bool accept);

#ifndef QT_NO_TEXTEDIT

    void setExtraSelections(const QList<QTextEdit::ExtraSelection> &selections);

    QList<QTextEdit::ExtraSelection> extraSelections() const;

#endif

    void setTextWidth(qreal width);

    qreal textWidth() const;

    QSizeF size() const;

    void setOpenExternalLinks(bool open);

    bool openExternalLinks() const;

    void moveCursor(QTextCursor::MoveOperation op, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor);

    bool canPaste() const;

    void setCursorIsFocusIndicator(bool b);

    bool cursorIsFocusIndicator() const;

#ifndef QT_NO_PRINTER

    void print(QPrinter *printer) const;

#endif

    virtual int hitTest(const QPointF &point, Qt::HitTestAccuracy accuracy) const;

    virtual QRectF blockBoundingRect(const QTextBlock &block) const;

    QAbstractTextDocumentLayout::PaintContext getPaintContext(QWidget *widget) const;

public Q_SLOTS:

    void setPlainText(const QString &text);

    void setHtml(const QString &text);

#ifndef QT_NO_CLIPBOARD

    void cut();

    void copy();

    void paste();

#endif

    void undo();

    void redo();

    void clear();

    void selectAll();

    void insertPlainText(const QString &text);

#ifndef QT_NO_TEXTHTMLPARSER

    void insertHtml(const QString &text);

#endif

    void append(const QString &text);

    void appendHtml(const QString &html);

    void appendPlainText(const QString &text);

    void adjustSize();

Q_SIGNALS:

    void textChanged();

    void undoAvailable(bool b);

    void redoAvailable(bool b);

    void currentCharFormatChanged(const QTextCharFormat &format);

    void copyAvailable(bool b);

    void selectionChanged();

    void cursorPositionChanged();

    // control signals

    void updateRequest(const QRectF &rect = QRectF());

    void documentSizeChanged(const QSizeF &);

    void blockCountChanged(int newBlockCount);

    void visibilityRequest(const QRectF &rect);

    void microFocusChanged();

    void linkActivated(const QString &link);

    void linkHovered(const QString &);

    void modificationChanged(bool m);

public:

    // control properties

    QPalette palette() const;

    void setPalette(const QPalette &pal);

    virtual void processEvent(QEvent *e, const QMatrix &matrix, QWidget *contextWidget = 0);

    void processEvent(QEvent *e, const QPointF &coordinateOffset = QPointF(), QWidget *contextWidget = 0);

    // control methods

    void drawContents(QPainter *painter, const QRectF &rect = QRectF(), QWidget *widget = 0);

    void setFocus(bool focus, Qt::FocusReason = Qt::OtherFocusReason);

    virtual QVariant inputMethodQuery(Qt::InputMethodQuery property) const;

    virtual QMimeData *createMimeDataFromSelection() const;

    virtual bool canInsertFromMimeData(const QMimeData *source) const;

    virtual void insertFromMimeData(const QMimeData *source);

    bool setFocusToAnchor(const QTextCursor &newCursor);

    bool setFocusToNextOrPreviousAnchor(bool next);

    bool findNextPrevAnchor(const QTextCursor& from, bool next, QTextCursor& newAnchor);

protected:

    virtual void timerEvent(QTimerEvent *e);

    virtual bool event(QEvent *e);

private:

    Q_DISABLE_COPY(QTextControl)

    Q_PRIVATE_SLOT(d_func(), void _q_updateCurrentCharFormatAndSelection())

    Q_PRIVATE_SLOT(d_func(), void _q_emitCursorPosChanged(const QTextCursor &))

    Q_PRIVATE_SLOT(d_func(), void _q_deleteSelected())

    Q_PRIVATE_SLOT(d_func(), void _q_copyLink())

    Q_PRIVATE_SLOT(d_func(), void _q_updateBlock(const QTextBlock &))

    Q_PRIVATE_SLOT(d_func(), void _q_documentLayoutChanged())

};

#ifndef QT_NO_CONTEXTMENU

class QUnicodeControlCharacterMenu : public QMenu

{

    Q_OBJECT

public:

    QUnicodeControlCharacterMenu(QObject *editWidget, QWidget *parent);

private Q_SLOTS:

    void menuActionTriggered();

private:

    QObject *editWidget;

};

#endif // QT_NO_CONTEXTMENU

// also used by QLabel

class QTextEditMimeData : public QMimeData

{

public:

    inline QTextEditMimeData(const QTextDocumentFragment &aFragment) : fragment(aFragment) {}

    virtual QStringList formats() const;

protected:

    virtual QVariant retrieveData(const QString &mimeType, QVariant::Type type) const;

private:

    void setup() const;

    mutable QTextDocumentFragment fragment;

};

QT_END_NAMESPACE

QT_END_HEADER

#endif // QTEXTCONTROL_H