]> git.lyx.org Git - lyx.git/blobdiff - src/Cursor.h
Now we can restore the old (and better) behavior of descriptions.
[lyx.git] / src / Cursor.h
index 0d49502ef1903ece576a8f1ea496cb439ada44eb..81b2d9b97e472df9ba9c64c6b3f72127947ef2e6 100644 (file)
@@ -4,7 +4,7 @@
  * This file is part of LyX, the document processor.
  * Licence details can be found in the file COPYING.
  *
- * \author André Pönitz
+ * \author André Pönitz
  *
  * Full author contact details are available in file CREDITS.
  */
@@ -17,6 +17,8 @@
 #include "Font.h"
 #include "Undo.h"
 
+#include "mathed/MathParser_flags.h"
+
 #include <vector>
 
 
@@ -37,7 +39,8 @@ class Encoding;
 
 // The public inheritance should go in favour of a suitable data member
 // (or maybe private inheritance) at some point of time.
-class Cursor : public DocIterator {
+class Cursor : public DocIterator
+{
 public:
        /// create the cursor of a BufferView
        explicit Cursor(BufferView & bv);
@@ -60,6 +63,8 @@ public:
        void leaveInset(Inset const & inset);
        /// sets cursor part
        void setCursor(DocIterator const & it);
+       /// sets the cursor to the anchor
+       void setCursorToAnchor();
 
        ///
        void setCurrentFont();
@@ -69,12 +74,18 @@ public:
        //
        /// selection active?
        bool selection() const { return selection_; }
-       /// selection active?
-       bool & selection() { return selection_; }
+       /// set selection;
+       void setSelection(bool sel) { selection_ = sel; }
+       /// do we have a multicell selection?
+       bool selIsMultiCell() const 
+               { return selection_ && selBegin().idx() != selEnd().idx(); }
+       /// do we have a multiline selection?
+       bool selIsMultiLine() const 
+               { return selection_ && selBegin().pit() != selEnd().pit(); }
        /// did we place the anchor?
        bool mark() const { return mark_; }
        /// did we place the anchor?
-       bool & mark() { return mark_; }
+       void setMark(bool mark) { mark_ = mark; }
        ///
        void setSelection();
        /// set selection at given position
@@ -89,12 +100,17 @@ public:
        DocIterator selectionBegin() const;
        /// access start of selection
        DocIterator selectionEnd() const;
-       /// FIXME: document this
+       /**
+        * Update the selection status and save permanent
+        * selection if needed.
+        * @param selecting the new selection status
+        * @return whether the selection status has changed
+        */
        bool selHandle(bool selecting);
        ///
        docstring selectionAsString(bool label) const;
        ///
-       docstring currentState();
+       docstring currentState() const;
 
        /// auto-correct mode
        bool autocorrect() const { return autocorrect_; }
@@ -106,6 +122,12 @@ public:
        bool & macromode() { return macromode_; }
        /// returns x,y position
        void getPos(int & x, int & y) const;
+       /// return logical positions between which the cursor is situated
+       /**
+        * If the cursor is at the edge of a row, the position which is "over the 
+        * edge" will be returned as -1.
+        */
+       void getSurroundingPos(pos_type & left_pos, pos_type & right_pos);
        /// the row in the paragraph we're in
        Row const & textRow() const;
 
@@ -116,6 +138,38 @@ public:
        bool posBackward();
        /// move one step forward
        bool posForward();
+       /// move visually one step to the right
+       /**
+        * @note: This method may move into an inset unless skip_inset == true.
+        * @note: This method may move into a new paragraph.
+        * @note: This method may move out of the current slice.
+        * @return: true if moved, false if not moved
+        */
+       bool posVisRight(bool skip_inset = false);
+       /// move visually one step to the left
+       /**
+        * @note: This method may move into an inset unless skip_inset == true.
+        * @note: This method may move into a new paragraph.
+        * @note: This method may move out of the current slice.
+        * @return: true if moved, false if not moved
+        */
+       bool posVisLeft(bool skip_inset = false);
+       /// move visually to next/previous row
+       /**
+        * Assuming we were to keep moving left (right) from the current cursor
+        * position, place the cursor at the rightmost (leftmost) edge of the 
+        * new row to which we would move according to visual-mode cursor movement.
+        * This could be either the next or the previous row, depending on the
+        * direction in which we're moving, and whether we're in an LTR or RTL 
+        * paragraph. 
+        * @note: The new position may even be in a new paragraph.
+        * @note: This method will not move out of the current slice.
+        * @return: false if not moved (no more rows to move to in given direction)
+        * @return: true if moved
+        */
+       bool posVisToNewRow(bool movingLeft);
+       /// move to right or left extremity of the current row
+       void posVisToRowExtremity(bool left);
 
        /// insert an inset
        void insert(Inset *);
@@ -146,8 +200,6 @@ public:
        void resetAnchor();
        /// access to owning BufferView
        BufferView & bv() const;
-       /// access to owning Buffer
-       Buffer & buffer() const;
        /// get some interesting description of top position
        void info(odocstream & os) const;
        /// are we in math mode (2), text mode (1) or unsure (0)?
@@ -196,26 +248,35 @@ public:
        bool textRedo();
 
        /// makes sure the next operation will be stored
-       void finishUndo();
+       void finishUndo() const;
+
+       /// open a new group of undo operations. Groups can be nested.
+       void beginUndoGroup() const;
+
+       /// end the current undo group
+       void endUndoGroup() const;
 
        /// The general case: prepare undo for an arbitrary range.
-       void recordUndo(UndoKind kind, pit_type from, pit_type to);
+       void recordUndo(UndoKind kind, pit_type from, pit_type to) const;
 
        /// Convenience: prepare undo for the range between 'from' and cursor.
-       void recordUndo(UndoKind kind, pit_type from);
+       void recordUndo(UndoKind kind, pit_type from) const;
 
        /// Convenience: prepare undo for the single paragraph or cell
        /// containing the cursor
-       void recordUndo(UndoKind kind = ATOMIC_UNDO);
+       void recordUndo(UndoKind kind = ATOMIC_UNDO) const;
 
        /// Convenience: prepare undo for the inset containing the cursor
-       void recordUndoInset(UndoKind kind = ATOMIC_UNDO);
+       void recordUndoInset(UndoKind kind = ATOMIC_UNDO) const;
 
        /// Convenience: prepare undo for the whole buffer
-       void recordUndoFullDocument();
+       void recordUndoFullDocument() const;
+
+       /// Convenience: prepare undo for the selected paragraphs or cells
+       void recordUndoSelection() const;
 
-       /// Convenience: prepare undo for the selected paragraphs
-       void recordUndoSelection();
+       ///
+       void checkBufferStructure();
 
 public:
        ///
@@ -298,6 +359,8 @@ public:
        /// move the cursor up by sending an internal LFUN_DOWN,
        /// return true if fullscreen update is needed
        bool down();
+       /// whether the cursor is either at the first or last row
+       bool atFirstOrLastRow(bool up);
        /// move up/down in a text inset, called for LFUN_UP/DOWN,
        /// return true if successful, updateNeeded set to true if fullscreen
        /// update is needed, otherwise it's not touched
@@ -312,7 +375,7 @@ public:
        ///
        void niceInsert(MathAtom const & at);
        ///
-       void niceInsert(docstring const & str);
+       void niceInsert(docstring const & str, Parse::flags f = Parse::NORMAL);
 
        /// in pixels from top of screen
        void setScreenPos(int x, int y);
@@ -325,6 +388,8 @@ public:
        bool inMacroMode() const;
        /// get access to the macro we are currently typing
        InsetMathUnknown * activeMacro();
+       /// get access to the macro we are currently typing
+       InsetMathUnknown const * activeMacro() const;
 
        /// replace selected stuff with at, placing the former
        // selection in given cell of atom
@@ -351,7 +416,7 @@ public:
        /// display an error message
        void errorMessage(docstring const & msg) const;
        ///
-       docstring getPossibleLabel();
+       docstring getPossibleLabel() const;
 
        /// the name of the macro we are currently inputting
        docstring macroName();
@@ -367,11 +432,12 @@ public:
 
 
 /**
- * Notifies all insets which appear in old, but not in cur. Make
- * Sure that the cursor old is valid, i.e. als inset pointer
+ * Notifies all insets which appear in old, but not in cur. And then
+ * notify all insets which appear in cur, but not in old.
+ * Make sure that the cursor old is valid, i.e. all inset pointers
  * point to valid insets! Use Cursor::fixIfBroken if necessary.
  */
-bool notifyCursorLeaves(DocIterator const & old, Cursor & cur);
+bool notifyCursorLeavesOrEnters(Cursor const & old, Cursor & cur);
 
 
 } // namespace lyx