movingcursor.h

Go to the documentation of this file.

/* This file is part of the KDE project
 *
 *  Copyright (C) 2010 Christoph Cullmann <cullmann@kde.org>
 *
 *  Based on code of the SmartCursor/Range by:
 *  Copyright (C) 2003-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_MOVINGCURSOR_H
#define KDELIBS_KTEXTEDITOR_MOVINGCURSOR_H

#include <kdebug.h>
#include <ktexteditor/ktexteditor_export.h>
#include <ktexteditor/cursor.h>
#include <ktexteditor/document.h>

namespace KTextEditor
{

class MovingRange;

class KTEXTEDITOR_EXPORT MovingCursor
{
  //
  // sub types
  //
  public:
    enum InsertBehavior {
      StayOnInsert = 0x0, 
      MoveOnInsert = 0x1  
    };

    enum WrapBehavior {
      Wrap = 0x0,  
      NoWrap = 0x1 
    };

  //
  // stuff that needs to be implemented by editor part cusors
  //
  public:
    virtual void setInsertBehavior (InsertBehavior insertBehavior) = 0;

    virtual InsertBehavior insertBehavior () const = 0;

    virtual Document *document () const = 0;

    virtual MovingRange *range () const = 0;

    virtual void setPosition (const KTextEditor::Cursor& position) = 0;

    virtual int line() const = 0;

    virtual int column() const = 0;

    virtual ~MovingCursor ();

  //
  // forbidden stuff
  //
  protected:
    MovingCursor ();

  private:
    MovingCursor (const MovingCursor &);

    MovingCursor &operator= (const MovingCursor &);

  //
  // convenience API
  //
  public:

    inline bool isValid() const {
      return line() >= 0 && column() >= 0;
    }

    // TODO KDE5: use KTE::Document::isValidTextPosition()
    inline bool isValidTextPosition() const {
      return isValid() && line() < document()->lines() && column() <= document()->lineLength(line());
    }

    void setPosition (int line, int column);

    void setLine(int line);

    void setColumn(int column);

    bool atStartOfLine() const;

    bool atEndOfLine() const;

    bool atStartOfDocument() const;

    bool atEndOfDocument() const;

    bool gotoNextLine();

    bool gotoPreviousLine();

    bool move(int chars, WrapBehavior wrapBehavior = Wrap);

    const Cursor toCursor () const { return Cursor (line(), column()); }

    operator const Cursor () const { return Cursor (line(), column()); }

//
// operators for: MovingCursor <-> MovingCursor
//
    inline friend bool operator==(const MovingCursor& c1, const MovingCursor& c2)
      { return c1.line() == c2.line() && c1.column() == c2.column(); }

    inline friend bool operator!=(const MovingCursor& c1, const MovingCursor& c2)
      { return !(c1 == c2); }

    inline friend bool operator>(const MovingCursor& c1, const MovingCursor& c2)
      { return c1.line() > c2.line() || (c1.line() == c2.line() && c1.column() > c2.column()); }

    inline friend bool operator>=(const MovingCursor& c1, const MovingCursor& c2)
      { return c1.line() > c2.line() || (c1.line() == c2.line() && c1.column() >= c2.column()); }

    inline friend bool operator<(const MovingCursor& c1, const MovingCursor& c2)
      { return !(c1 >= c2); }

    inline friend bool operator<=(const MovingCursor& c1, const MovingCursor& c2)
      { return !(c1 > c2); }

    inline friend QDebug operator<< (QDebug s, const MovingCursor *cursor) {
      if (cursor)
        s.nospace() << "(" << cursor->line() << ", " << cursor->column() << ")";
      else
        s.nospace() << "(null cursor)";
      return s.space();
    }

    inline friend QDebug operator<< (QDebug s, const MovingCursor &cursor) {
      return s << &cursor;
    }
};

}

#endif

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