smartinterface.h

Go to the documentation of this file.

/* This file is part of the KDE project
   Copyright (C) 2005 Hamish Rodda <rodda@kde.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 KDELIBS_KTEXTEDITOR_SMARTINTERFACE_H
#define KDELIBS_KTEXTEDITOR_SMARTINTERFACE_H

#include <ktexteditor/ktexteditor_export.h>
#include <ktexteditor/smartrange.h>

class QMutex;

namespace KTextEditor
{
class Document;
class View;
class SmartCursor;

class KTEXTEDITOR_EXPORT SmartInterface
{
  friend class Attribute;

  public:
    SmartInterface();
    virtual ~SmartInterface();

    QMutex* smartMutex() const;

    virtual void clearSmartInterface() = 0;

    bool clearOnDocumentReload() const;

    void setClearOnDocumentReload(bool clearOnReload);

    //BEGIN New cursor methods
    virtual int currentRevision() const = 0;

    virtual void releaseRevision(int revision) const = 0;

    virtual void useRevision(int revision) = 0;

    void clearRevision();

    virtual KTextEditor::Cursor translateFromRevision(const KTextEditor::Cursor& cursor, KTextEditor::SmartCursor::InsertBehavior insertBehavior = KTextEditor::SmartCursor::StayOnInsert) const;

    virtual KTextEditor::Range translateFromRevision(const KTextEditor::Range& range, KTextEditor::SmartRange::InsertBehaviors insertBehavior = KTextEditor::SmartRange::ExpandLeft | KTextEditor::SmartRange::ExpandRight) const;

    virtual SmartCursor* newSmartCursor(const Cursor& position = Cursor::start(), SmartCursor::InsertBehavior insertBehavior = SmartCursor::MoveOnInsert) = 0;

    SmartCursor* newSmartCursor(int line, int column, SmartCursor::InsertBehavior insertBehavior = SmartCursor::MoveOnInsert);

    virtual void deleteCursors() = 0;
    //END

    //BEGIN New range methods
    virtual SmartRange* newSmartRange(const Range& range = Range(),
                                      SmartRange* parent = 0L,
                                      SmartRange::InsertBehaviors insertBehavior = SmartRange::DoNotExpand) = 0;

    SmartRange* newSmartRange(const Cursor& startPosition,
                                     const Cursor& endPosition,
                                     SmartRange* parent = 0L,
                                     SmartRange::InsertBehaviors insertBehavior = SmartRange::DoNotExpand);

    SmartRange* newSmartRange(int startLine, int startColumn, int endLine, int endColumn, SmartRange* parent = 0L, SmartRange::InsertBehaviors insertBehavior = SmartRange::DoNotExpand);

    virtual SmartRange* newSmartRange(SmartCursor* start, SmartCursor* end, SmartRange* parent = 0L, SmartRange::InsertBehaviors insertBehavior = SmartRange::DoNotExpand) = 0;

    virtual void unbindSmartRange(SmartRange* range) = 0;

    virtual void deleteRanges() = 0;
    //END

    //BEGIN Syntax highlighting extension
    virtual void addHighlightToDocument(SmartRange* topRange, bool supportDynamic = false) = 0;

    virtual void removeHighlightFromDocument(SmartRange* topRange) = 0;

    virtual const QList<SmartRange*> documentHighlights() const = 0;

    virtual void clearDocumentHighlights() = 0;

    virtual void addHighlightToView(View* view, SmartRange* topRange, bool supportDynamic = false) = 0;

    virtual void removeHighlightFromView(View* view, SmartRange* topRange) = 0;

    virtual const QList<SmartRange*> viewHighlights(View* view) const = 0;

    virtual void clearViewHighlights(View* view) = 0;
    //END

    //BEGIN Action binding extension - not implemented
    /* not implemented
     * Register a SmartRange tree as providing bound actions,
     * and that they should interact with all of the views of a document.
     *
     * \param topRange the top range of the tree to add
     */
    virtual void addActionsToDocument(SmartRange* topRange) = 0;

    /* not implemented
     * Remove a SmartRange tree from providing bound actions
     * to all of the views of a document.
     *
     * \param topRange the top range of the tree to remove
     */
    virtual void removeActionsFromDocument(SmartRange* topRange) = 0;

    /* not implemented
     * Return a list of SmartRange%s which are currently registered as
     * providing bound actions to all of the views of a document.
     */
    virtual const QList<SmartRange*> documentActions() const = 0;

    /* not implemented
     * Remove all bound SmartRange%s which provide actions to the document.
     */
    virtual void clearDocumentActions() = 0;

    /* not implemented
     * Register a SmartRange tree as providing bound actions,
     * and that they should interact with the specified \p view.
     *
     * \param view view on which to use the actions
     * \param topRange the top range of the tree to add
     */
    virtual void addActionsToView(View* view, SmartRange* topRange) = 0;

    /* not implemented
     * Remove a SmartRange tree from providing bound actions
     * to the specified \p view.
     *
     * \note implementations should not take into account document-bound
     *       action ranges when calling this function; it is intended solely
     *       to be the counter of addActionsToView()
     *
     * \param view view on which the actions were previously used
     * \param topRange the top range of the tree to remove
     */
    virtual void removeActionsFromView(View* view, SmartRange* topRange) = 0;

    /* not implemented
     * Return a list of SmartRange%s which are currently registered as
     * providing bound actions to the specified \p view.
     *
     * \note implementations should not take into account document-bound
     *       action ranges when returning the list; it is intended solely
     *       to show actions added via addActionsToView()
     *
     * \param view view to query for the action list
     */
    virtual const QList<SmartRange*> viewActions(View* view) const = 0;

    /* not implemented
     * Remove all bound SmartRange%s which provide actions to the specified \p view.
     *
     * \param view view from which to remove actions
     */
    virtual void clearViewActions(View* view) = 0;
    //END

  protected:
    virtual void attributeDynamic(Attribute::Ptr a) = 0;
    virtual void attributeNotDynamic(Attribute::Ptr a) = 0;

  private:
    class SmartInterfacePrivate* const d;
};

}

Q_DECLARE_INTERFACE(KTextEditor::SmartInterface, "org.kde.KTextEditor.SmartInterface")

#endif

// kate: space-indent on; indent-width 2; replace-tabs on;