]> git.lyx.org Git - lyx.git/blobdiff - src/mathed/math_cursor.h
make \newcommand{\bb}[1]{\mathbf{#1}} work for read/write/display.
[lyx.git] / src / mathed / math_cursor.h
index 513886d97a902df095addcfd363e14bdb8481880..6e2742fd6505e64415185e9b946663798f44836f 100644 (file)
 
 #include "math_defs.h"
 #include "math_inset.h"
+#include "math_pos.h"
 #include "LString.h"
 
-class MathInset;
-class MathAtom;
-class MathGridInset;
-class MathFuncInset;
-class MathHullInset;
-class MathScriptInset;
-class MathSpaceInset;
 class InsetFormulaBase;
-class MathArray;
-class MathXArray;
 class Painter;
 class Selection;
-class latexkeys;
 
-/// Description of a position 
-struct MathCursorPos {
-       /// inset
-       MathAtom * par_;
-       /// cell index
-       MathInset::idx_type idx_;
-       /// cell position
-       MathInset::pos_type pos_;
+/**
 
-       /// returns cell corresponding to this position
-       MathArray & cell() const;
-       /// returns cell corresponding to this position
-       MathArray & cell(MathInset::idx_type idx) const;
-       /// returns xcell corresponding to this position
-       MathXArray & xcell() const;
-       /// returns xcell corresponding to this position
-       MathXArray & xcell(MathInset::idx_type idx) const;
-};
+[Have a look at math_inset.h first]
+
+The MathCursor is different from the kind of cursor used in the Outer
+World. It contains a stack of MathCursorPositions, each of which is made
+up of a inset pointer, an index and a position offset, marking a path from
+this formula's mathHullInset to the current position.
 
-/// 
-bool operator==(MathCursorPos const &, MathCursorPos const &);
-/// 
-bool operator<(MathCursorPos const &, MathCursorPos const &);
+*/
 
 
-/// This is the external interface of Math's subkernel
 class MathCursor {
 public:
        /// short of anything else reasonable
-       typedef MathInset::size_type    size_type;
+       typedef MathInset::size_type       size_type;
        /// type for cursor positions within a cell
-       typedef MathInset::pos_type     pos_type;
+       typedef MathInset::pos_type        pos_type;
        /// type for cell indices
-       typedef MathInset::idx_type     idx_type;
+       typedef MathInset::idx_type        idx_type;
        /// type for row numbers
-       typedef MathInset::row_type     row_type;
+       typedef MathInset::row_type        row_type;
        /// type for column numbers
-       typedef MathInset::col_type     col_type;
+       typedef MathInset::col_type        col_type;
+       /// how to store a cursor
+       typedef std::vector<MathCursorPos> cursor_type;
 
        ///
        explicit MathCursor(InsetFormulaBase *, bool left);
@@ -90,25 +69,25 @@ public:
        void erase();
        ///
        void backspace();
-       ///
+       /// called for LFUN_HOME etc
        void home(bool sel = false);
-       ///
+       /// called for LFUN_END etc
        void end(bool sel = false);
-       ///
+       /// called for LFUN_RIGHT and LFUN_RIGHTSEL
        bool right(bool sel = false);
-       ///
+       /// called for LFUN_LEFT etc
        bool left(bool sel = false);
-       ///
+       /// called for LFUN_UP etc
        bool up(bool sel = false);
-       ///
+       /// called for LFUN_DOWN etc
        bool down(bool sel = false);
        /// Put the cursor in the first position
        void first();
        /// Put the cursor in the last position
        void last();
-       ///
+       /// move to next cell in current inset
        void idxNext();
-       ///
+       /// move to previous cell in current inset
        void idxPrev();
        ///
        void plainErase();
@@ -119,30 +98,31 @@ public:
 
        ///
        void delLine();
-       /// This is in pixels from (maybe?) the top of inset
-       void setPos(int, int);
-       ///
+       /// in pixels from top of screen
+       void setPos(int x, int y);
+       /// in pixels from top of screen
        void getPos(int & x, int & y);
-       ///
-       MathAtom & par() const;
+       /// current inset
+       MathInset * par() const;
        /// return the next enclosing grid inset and the cursor's index in it
        MathGridInset * enclosingGrid(idx_type &) const;
        ///
-       InsetFormulaBase const * formula();
-       ///
+       InsetFormulaBase * formula();
+       /// current offset in the current cell
        pos_type pos() const;
-       ///
+       /// current cell
        idx_type idx() const;
-       ///
+       /// size of current cell
        size_type size() const;
        ///
+       bool script(bool);
+       ///
        bool interpret(string const &);
        ///
        bool interpret(char);
        ///
        bool toggleLimits();
-       ///
-       // Macro mode methods
+       /// interpret name a name of a macro
        void macroModeClose();
        ///
        bool inMacroMode() const;
@@ -174,14 +154,14 @@ public:
        void handleDelim(string const & l, string const & r);
        ///
        void handleNest(MathInset * p);
-       /// Splits cells and shifts right part to the next cell
+       /// splits cells and shifts right part to the next cell
        void splitCell();
-       /// Splits line and insert new row of cell 
+       /// splits line and insert new row of cell 
        void breakLine();
        /// read contents of line into an array
        void readLine(MathArray & ar) const;
-       ///
-       MathTextCodes getLastCode() const;
+       /// remove this as soon as LyXFunc::getStatus is "localized"
+       MathTextCodes getLastCode() const { return lastcode_; }
        ///
        void pullArg(bool goright);
        ///
@@ -193,14 +173,16 @@ public:
        ///
        char halign() const;
        ///
-       col_type ncols() const;
+       col_type hullCol() const;
+       ///
+       row_type hullRow() const;
        ///
-       col_type col() const;
+       col_type gridCol() const;
        ///
-       row_type row() const;
+       row_type gridRow() const;
 
-       /// Make sure cursor position is valid
-       void normalize() const;
+       /// make sure cursor position is valid
+       void normalize();
        ///
        UpdatableInset * asHyperActiveInset() const;
 
@@ -238,21 +220,23 @@ public:
        MathCursorPos normalAnchor() const;
 
        /// path of positions the cursor had to go if it were leving each inset
-       std::vector<MathCursorPos> Cursor_;
+       cursor_type Cursor_;
        /// path of positions the anchor had to go if it were leving each inset
-       std::vector<MathCursorPos> Anchor_;
+       mutable cursor_type Anchor_;
 
-       /// reference to the last item of the path
+       /// reference to the last item of the path, i.e. "The Cursor"
        MathCursorPos & cursor();
-       ///
+       /// reference to the last item of the path, i.e. "The Cursor"
        MathCursorPos const & cursor() const;
 
-       ///
+       /// dump selection information for debugging
        void seldump(char const * str) const;
-       ///
+       /// dump selection information for debugging
        void dump(char const * str) const;
        ///
        void stripFromLastEqualSign();
+       /// moves on 
+       void setSelection(cursor_type const & where, size_type n);
 
        ///
        friend class Selection;
@@ -266,38 +250,26 @@ private:
        bool idxLeft();
        /// moves cursor index one cell to the right
        bool idxRight();
-       /// moves position somehow up
-       bool goUp();
-       /// moves position somehow down
-       bool goDown();
+       /// moves position somehow up or down
+       bool goUpDown(bool up);
+       /// moves position into box
+       bool bruteFind(int xo, int yo, int xlow, int xhigh, int ylow, int yhigh);
 
        ///
        string macroName() const;
        ///
-       int macroNamePos() const;
+       MathInset::difference_type macroNamePos() const;
        ///
        void insert(char, MathTextCodes t);
        /// can we enter the inset? 
        bool openable(MathAtom const &, bool selection) const;
-       /// can the setPos routine enter that inset?
-       bool positionable(MathAtom const &, int x, int y) const;
        /// write access to cursor cell position
        pos_type & pos();
        /// write access to cursor cell index
        idx_type & idx();
-       /// x-offset of current cell relative to par xo
-       int cellXOffset() const;
-       /// y-offset of current cell relative to par yo
-       int cellYOffset() const;
-       /// current x position relative to par xo
-       int xpos() const;
-       /// current y position relative to par yo
-       int ypos() const;
-       /// adjust position in current cell according to x. idx is not changed.
-       void gotoX(int x);
 
        ///
-       InsetFormulaBase * const formula_;
+       InsetFormulaBase * formula_;
        ///
        MathTextCodes lastcode_;
        // Selection stuff