#ifndef CURSOR_H
#define CURSOR_H
-#include "cursor_slice.h"
#include "dispatchresult.h"
+#include "dociterator.h"
#include <iosfwd>
#include <vector>
+
+namespace lyx {
+
+class Buffer;
class BufferView;
-class UpdatableInset;
-class MathAtom;
-class DispatchResult;
class FuncStatus;
class FuncRequest;
-class InsetTabular;
-class LyXText;
-class Paragraph;
+class LyXFont;
class Row;
-
// these should go
-class MathHullInset;
-class MathUnknownInset;
-class MathGridInset;
-
-
-// only needed for gcc 2.95, remove when support terminated
-template <typename A, typename B>
-bool ptr_cmp(A const * a, B const * b)
-{
- return a == b;
-}
+class InsetMathUnknown;
+class Encoding;
-// this is used for traversing math insets
-typedef std::vector<CursorSlice> CursorBase;
-/// move on one step
-void increment(CursorBase &);
-///
-CursorBase ibegin(InsetBase * p);
-///
-CursorBase iend(InsetBase * p);
+/// The cursor class describes the position of a cursor within a document.
-
-/**
- * The cursor class describes the position of a cursor within a document.
- */
-
-class LCursor {
+// The public inheritance should go in favour of a suitable data member
+// (or maybe private inheritance) at some point of time.
+class LCursor : public DocIterator {
public:
- /// type for cell number in inset
- typedef CursorSlice::idx_type idx_type;
- /// type for paragraph numbers positions within a cell
- typedef CursorSlice::par_type par_type;
- /// type for cursor positions within a cell
- typedef CursorSlice::pos_type pos_type;
- /// type for row indices
- typedef CursorSlice::row_type row_type;
- /// type for col indices
- typedef CursorSlice::col_type col_type;
-
/// create the cursor of a BufferView
explicit LCursor(BufferView & bv);
- /// dispatch from innermost inset upwards
- DispatchResult dispatch(FuncRequest const & cmd);
- /// are we willing to handle this event?
- bool getStatus(FuncRequest const & cmd, FuncStatus & flag);
+ /// dispatch from innermost inset upwards
+ void dispatch(FuncRequest const & cmd);
+ /// get the resut of the last dispatch
+ DispatchResult result() const;
/// add a new cursor slice
- void push(InsetBase * inset);
+ void push(InsetBase & inset);
/// add a new cursor slice, place cursor on left end
- void pushLeft(InsetBase * inset);
+ void pushLeft(InsetBase & inset);
/// pop one level off the cursor
void pop();
/// pop one slice off the cursor stack and go left
bool popLeft();
/// pop one slice off the cursor stack and go right
bool popRight();
- /// restrict cursor nesting to given size
- void pop(int depth);
- /// access to current cursor slice
- CursorSlice & current();
- /// access to current cursor slice
- CursorSlice const & current() const;
- /// how many nested insets do we have?
- size_t depth() const { return cursor_.size(); }
- /// depth of current slice
- int currentDepth() const { return current_; }
+ /// make sure we are outside of given inset
+ void leaveInset(InsetBase const & inset);
+ /// sets cursor part
+ void setCursor(DocIterator const & it);
//
// selection
///
void setSelection();
/// set selection at given position
- void setSelection(CursorBase const & where, size_t n);
+ void setSelection(DocIterator const & where, int n);
///
void clearSelection();
/// access start of selection
- CursorSlice & selBegin();
- /// access start of selection
- CursorSlice const & selBegin() const;
+ CursorSlice selBegin() const;
/// access end of selection
- CursorSlice & selEnd();
- /// access end of selection
- CursorSlice const & selEnd() const;
- ///
- std::string grabSelection();
- ///
- void eraseSelection();
- ///
- std::string grabAndEraseSelection();
- // other selection methods
- ///
- void selCopy();
- ///
- void selCut();
- ///
- void selDel();
- /// pastes n-th element of cut buffer
- void selPaste(size_t n);
+ CursorSlice selEnd() const;
+ /// access start of selection
+ DocIterator selectionBegin() const;
+ /// access start of selection
+ DocIterator selectionEnd() const;
///
- void selHandle(bool selecting);
- /// start selection
- void selStart();
- /// clear selection
- void selClear();
- /// clears or deletes selection depending on lyxrc setting
- void selClearOrDel();
+ bool selHandle(bool selecting);
//
- std::string selectionAsString(bool label) const;
- ///
- void paste(std::string const & data);
+ docstring selectionAsString(bool label) const;
///
std::string currentState();
- //
- // access to the 'current' cursor slice
- //
- /// the containing inset
- InsetBase * inset() const { return current().inset(); }
- /// return the cell of the inset this cursor is in
- idx_type idx() const { return current().idx(); }
- /// return the cell of the inset this cursor is in
- idx_type & idx() { return current().idx(); }
- /// return the last possible cell in this inset
- idx_type lastidx() const;
- /// return the paragraph this cursor is in
- par_type par() const { return current().par(); }
- /// return the paragraph this cursor is in
- par_type & par() { return current().par(); }
- /// return the last possible paragraph in this inset
- par_type lastpar() const;
- /// return the position within the paragraph
- pos_type pos() const { return current().pos(); }
- /// return the position within the paragraph
- pos_type & pos() { return current().pos(); }
- /// return the last position within the paragraph
- pos_type lastpos() const;
- /// return the display row of the cursor with in the current par
- row_type crow() const;
- /// return the display row of the cursor with in the current par
- row_type lastcrow() const;
-
- /// return the number of embedded cells
- size_t nargs() const;
- /// return the number of embedded cells
- size_t ncols() const;
- /// return the number of embedded cells
- size_t nrows() const;
- /// return the grid row of the current cell
- row_type row() const;
- /// return the last row of the current grid
- row_type lastrow() const { return nrows() - 1; }
- /// return the grid column of the current cell
- col_type col() const;
- /// return the last column of the current grid
- col_type lastcol() const { return ncols() - 1; }
- /// the inset just behind the cursor
- InsetBase * nextInset();
- /// the inset just in front of the cursor
- InsetBase * prevInset();
- /// the inset just in front of the cursor
- InsetBase const * prevInset() const;
-
- //
- // math-specific part
- //
- /// return the mathed cell this cursor is in
- MathArray const & cell() const;
- /// return the mathed cell this cursor is in
- MathArray & cell();
- /// the mathatom left of the cursor
- MathAtom const & prevAtom() const;
- /// the mathatom left of the cursor
- MathAtom & prevAtom();
- /// the mathatom right of the cursor
- MathAtom const & nextAtom() const;
- /// the mathatom right of the cursor
- MathAtom & nextAtom();
/// auto-correct mode
bool autocorrect() const { return autocorrect_; }
/// auto-correct mode
bool macromode() const { return macromode_; }
/// are we entering a macro name?
bool & macromode() { return macromode_; }
-
- //
- // text-specific part
- /// see comment for boundary_ below
- bool boundary() const { return current().boundary(); }
- /// see comment for boundary_ below
- bool & boundary() { return current().boundary(); }
- /// the paragraph we're in
- Paragraph & paragraph();
- /// the paragraph we're in
- Paragraph const & paragraph() const;
+ /// returns x,y position
+ void getPos(int & x, int & y) const;
/// the row in the paragraph we're in
Row & textRow();
/// the row in the paragraph we're in
Row const & textRow() const;
- ///
- LyXText * text() const;
- ///
- InsetBase * innerInsetOfType(int code) const;
- ///
- InsetTabular * innerInsetTabular() const;
- ///
- LyXText * innerText() const;
- ///
- CursorSlice const & innerTextSlice() const;
- /// returns x,y position
- void getPos(int & x, int & y) const;
- /// returns cursor dimension
- void getDim(int & asc, int & desc) const;
//
// common part
/// insert an inset
void insert(InsetBase *);
/// insert a single char
- void insert(char c);
+ void insert(char_type c);
/// insert a string
- void insert(std::string const & str);
+ void insert(docstring const & str);
+ /// in pixels from left of screen
+ int targetX() const;
/// write acess to target x position of cursor
int & x_target();
/// return target x position of cursor
int x_target() const;
+ /// set targetX in current position
+ void setTargetX();
/// clear target x position of cursor
void clearTargetX();
- /// access to selection anchor
- CursorSlice & anchor();
- /// access to selection anchor
- CursorSlice const & anchor() const;
- /// cache the absolute coordinate from the top inset
- void updatePos();
+ /// access to normalized selection anchor
+ CursorSlice anchor() const;
/// sets anchor to cursor position
- void resetAnchor();
+ void resetAnchor();
/// access to owning BufferView
- BufferView & bv() const;
- /// get some interesting description of current position
- void info(std::ostream & os) const;
+ 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)?
int currentMode();
- /// reset cursor
- void reset();
+ /// reset cursor bottom to the beginning of the given inset
+ // (sort of 'chroot' environment...)
+ void reset(InsetBase &);
/// for spellchecking
void replaceWord(std::string const & replacestring);
- /// update our view
- void update();
- ///
- void dispatched(dispatch_result_t res);
- void notdispatched();
- void noupdate();
+ /**
+ * the event was not (yet) dispatched.
+ *
+ * Should only be called by an inset's doDispatch() method. It means:
+ * I, the doDispatch() method of InsetFoo, hereby declare that I am
+ * not able to handle that request and trust my parent will do the
+ * Right Thing (even if my getStatus partner said that I can do it).
+ * It is sort of a kludge that should be used only rarely...
+ */
+ void undispatched();
+ /// the event was already dispatched
+ void dispatched();
+ /// Set which update should be done
+ void updateFlags(Update::flags f);
+ /**
+ * don't call update() when done
+ *
+ * Should only be called by an inset's doDispatch() method. It means:
+ * I handled that request and I can reassure you that the screen does
+ * not need to be re-drawn and all entries in the coord cache stay
+ * valid (and there are no other things to put in the coord cache).
+ * This is a fairly rare event as well and only some optimization.
+ * Not using noUpdate() should never be wrong.
+ */
+ void noUpdate();
+ /// fix cursor in circumstances that should never happen
+ void fixIfBroken();
/// output
friend std::ostream & operator<<(std::ostream & os, LCursor const & cur);
+
public:
+ ///
+ BufferView * bv_;
//private:
- /// mainly used as stack, but wee need random access
- std::vector<CursorSlice> cursor_;
/// the anchor position
- std::vector<CursorSlice> anchor_;
-
- ///
+ DocIterator anchor_;
+
+ ///
DispatchResult disp_;
+
private:
- ///
- BufferView * bv_;
- /// current slice
- int current_;
- ///
- int cached_y_;
/**
* The target x position of the cursor. This is used for when
* we have text like :
* shorter than x()
*/
int x_target_;
- // do we have a selection?
+ /// do we have a selection?
bool selection_;
- // are we on the way to get one?
+ /// are we on the way to get one?
bool mark_;
+ /// If true, we are behind the previous char, otherwise we are in front
+ // of the next char. This only make a difference when we are in front
+ // of a big inset spanning a whole row and computing coordinates for
+ // displaying the cursor.
+ bool logicalpos_;
+
+private:
//
// math specific stuff that could be promoted to "global" later
///
void niceInsert(MathAtom const & at);
///
- void niceInsert(std::string const & str);
+ void niceInsert(docstring const & str);
/// in pixels from top of screen
void setScreenPos(int x, int y);
- /// in pixels from left of screen
- int targetX() const;
- /// return the next enclosing grid inset and the cursor's index in it
- MathGridInset * enclosingGrid(idx_type & idx) const;
- /// adjust anchor position after deletions/insertions
- void adjust(pos_type from, int diff);
- ///
- MathHullInset * formula() const;
- /// current offset in the current cell
- ///
- bool script(bool);
- ///
- bool interpret(char);
- /// interpret name a name of a macro
- void macroModeClose();
+ /// current offset in the top cell
+
+ /// interpret name a name of a macro. Returns true if
+ /// something got inserted.
+ bool macroModeClose();
/// are we currently typing the name of a macro?
bool inMacroMode() const;
/// get access to the macro we are currently typing
- MathUnknownInset * activeMacro();
- /// are we currently typing '#1' or '#2' or...?
- bool inMacroArgMode() const;
+ InsetMathUnknown * activeMacro();
/// replace selected stuff with at, placing the former
// selection in given cell of atom
void handleNest(MathAtom const & at, int cell = 0);
- /// remove this as soon as LyXFunc::getStatus is "localized"
- //inline std::string getLastCode() { return "mathnormal"; }
///
bool isInside(InsetBase const *);
- ///
- char valign();
- ///
- char halign();
/// make sure cursor position is valid
void normalize();
/// mark current cursor trace for redraw
void touch();
- /// returns the normalized anchor of the selection
- CursorSlice normalAnchor();
-
- /// lock/unlock inset
- void lockToggle();
-
/// hack for reveal codes
void markInsert();
void markErase();
/// split font inset etc
void handleFont(std::string const & font);
- /// are we in mathed?
- bool inMathed() const;
- /// are we in texted?
- bool inTexted() const;
-
/// display a message
- void message(std::string const & msg) const;
+ void message(docstring const & msg) const;
/// display an error message
- void errorMessage(std::string const & msg) const;
+ void errorMessage(docstring const & msg) const;
///
- std::string getPossibleLabel();
+ docstring getPossibleLabel();
-private:
/// moves position somehow up or down
bool goUpDown(bool up);
- /// moves position closest to (x, y) in given box
- bool bruteFind(int x, int y, int xlow, int xhigh, int ylow, int yhigh);
- /// moves position closest to (x, y) in current cell
- void bruteFind2(int x, int y);
- /// are we in a nucleus of a script inset?
- bool inNucleus();
/// the name of the macro we are currently inputting
- std::string macroName();
+ docstring macroName();
/// where in the curent cell does the macro name start?
int macroNamePos();
-public:
/// can we enter the inset?
bool openable(MathAtom const &) const;
+ ///
+ Encoding const * getEncoding() const;
+ /// font at cursor position
+ LyXFont getFont() const;
};
+
+
+} // namespace lyx
+
#endif // LYXCURSOR_H