src/cursor.h

   1 // -*- C++ -*-
   2 /**
   3  * \file cursor.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author André Pönitz
   8  *
   9  * Full author contact details are available in file CREDITS.
  10  */
  11
  12 #ifndef CURSOR_H
  13 #define CURSOR_H
  14
  15 #include "cursor_slice.h"
  16
  17 #include <iosfwd>
  18 #include <vector>
  19
  20 class BufferView;
  21 class UpdatableInset;
  22 class DispatchResult;
  23 class FuncRequest;
  24 class LyXText;
  25 class InsetTabular;
  26
  27
  28 /**
  29  * The cursor class describes the position of a cursor within a document.
  30  */
  31
  32 class LCursor {
  33 public:
  34         /// type for cell number in inset
  35         typedef CursorSlice::idx_type idx_type;
  36         /// type for paragraph numbers positions within a cell
  37         typedef CursorSlice::par_type par_type;
  38         /// type for cursor positions within a cell
  39         typedef CursorSlice::pos_type pos_type;
  40
  41         /// create 'empty' cursor. REMOVE ME
  42         LCursor();
  43         /// create 'empty' cursor
  44         explicit LCursor(BufferView & bv);
  45         /// dispatch from innermost inset upwards
  46         DispatchResult dispatch(FuncRequest const & cmd);
  47         ///
  48         void push(InsetBase * inset);
  49         /// restrict cursor nesting to given size
  50         void pop(int depth);
  51         /// pop one level off the cursor
  52         void pop();
  53         /// access to cursor 'tip'
  54         CursorSlice & top() { return cursor_.back(); }
  55         /// access to cursor 'tip'
  56         CursorSlice const & top() const { return cursor_.back(); }
  57
  58         /// set the cell the cursor is in
  59         void cell(int);
  60         /// return the cell this cursor is in
  61         int cell() const;
  62         ///
  63         UpdatableInset * innerInset() const;
  64         ///
  65         UpdatableInset * innerInsetOfType(int code) const;
  66         ///
  67         InsetTabular * innerInsetTabular() const;
  68         ///
  69         LyXText * innerText() const;
  70         /// returns x,y position
  71         void getPos(int & x, int & y) const;
  72         /// returns cursor dimension
  73         void getDim(int & asc, int & desc) const;
  74         /// cache the absolute coordinate from the top inset
  75         void updatePos();
  76         /// sets anchor to cursor position
  77         void resetAnchor();
  78         /// sets anchor to cursor position
  79         BufferView & bv() const;
  80         ///
  81         friend std::ostream & operator<<(std::ostream &, LCursor const &);
  82 public:
  83         /// mainly used as stack, but wee need random access
  84         std::vector<CursorSlice> cursor_;
  85         /// The
  86         std::vector<CursorSlice> anchor_;
  87         ///
  88         BufferView * bv_;
  89 private:
  90         ///
  91         int cached_y_;
  92 };
  93
  94 #endif // LYXCURSOR_H