// -*- C++ -*-
-/*
- * File: math_cursor.h
- * Purpose: Declaration of interaction classes for mathed
- * Author: Alejandro Aguilar Sierra <asierra@servidor.unam.mx>
- * Created: January 1996
- * Description: MathCursor control all user interaction
+/**
+ * \file math_cursor.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
*
- * Dependencies: Xlib, XForms
+ * \author Alejandro Aguilar Sierra
+ * \author André Pönitz
*
- * Copyright: 1996, Alejandro Aguilar Sierra
- *
- * You are free to use and modify this code under the terms of
- * the GNU General Public Licence version 2 or later.
+ * Full author contact details are available in file CREDITS.
*/
#ifndef MATH_CURSOR
#define MATH_CURSOR
-#ifdef __GNUG__
-#pragma interface
-#endif
-
-#include "math_defs.h"
+#include "cursor_slice.h"
#include "math_inset.h"
-#include "LString.h"
+#include "math_data.h"
+
+#include <string>
-class MathInset;
-class MathAtom;
-class MathArrayInset;
-class MathFuncInset;
-class MathMatrixInset;
-class MathScriptInset;
-class MathSpaceInset;
class InsetFormulaBase;
-class MathArray;
-class MathXArray;
-class Painter;
-class Selection;
-class latexkeys;
+class BufferView;
+class PainterInfo;
+class MathUnknownInset;
-/// 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 CursorSlice, 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 size_t size_type;
+ /// type for column numbers
+ typedef ptrdiff_t difference_type;
/// type for cursor positions within a cell
- typedef MathInset::pos_type pos_type;
+ typedef lyx::pos_type pos_type;
/// type for cell indices
- typedef MathInset::idx_type idx_type;
+ typedef size_t idx_type;
/// type for row numbers
- typedef MathInset::row_type row_type;
+ typedef size_t row_type;
/// type for column numbers
- typedef MathInset::col_type col_type;
+ typedef size_t col_type;
///
- explicit MathCursor(InsetFormulaBase *, bool left);
- ///
- void insert(MathAtom const &);
- ///
- void insert(MathArray const &);
- ///
- void paste(MathArray const &);
- ///
- void erase();
- ///
- void backspace();
- ///
- void home(bool sel = false);
- ///
- void end(bool sel = false);
- ///
- bool right(bool sel = false);
- ///
- bool left(bool sel = false);
- ///
- bool up(bool sel = false);
- ///
- bool down(bool sel = false);
+ explicit MathCursor(BufferView *, InsetFormulaBase *, bool left);
+ ///
+ ~MathCursor();
+ ///
+ void insert(BufferView & bv, MathAtom const &);
+ ///
+ void insert(BufferView & bv, MathArray const &);
+ ///
+ void insert2(BufferView & bv, std::string const &);
+ ///
+ void paste(BufferView & bv, std::string const & data);
+ /// return false for empty math insets
+ bool erase(BufferView & bv);
+ /// return false for empty math insets
+ bool backspace(BufferView & bv);
+ /// called for LFUN_HOME etc
+ bool home(BufferView & bv, bool sel = false);
+ /// called for LFUN_END etc
+ bool end(BufferView & bv, bool sel = false);
+ /// called for LFUN_RIGHT and LFUN_RIGHTSEL
+ bool right(BufferView & bv, bool sel = false);
+ /// called for LFUN_LEFT etc
+ bool left(BufferView & bv, bool sel = false);
+ /// called for LFUN_UP etc
+ bool up(BufferView & bv, bool sel = false);
+ /// called for LFUN_DOWN etc
+ bool down(BufferView & bv, bool sel = false);
/// Put the cursor in the first position
- void first();
+ void first(BufferView & bv);
/// Put the cursor in the last position
- void last();
+ void last(BufferView & bv);
+ /// move to next cell in current inset
+ void idxNext(BufferView & bv);
+ /// move to previous cell in current inset
+ void idxPrev(BufferView & bv);
///
- void idxNext();
+ void plainErase(BufferView & bv);
///
- void idxPrev();
+ void plainInsert(BufferView & bv, MathAtom const & at);
///
- void plainErase();
+ void niceInsert(BufferView & bv, MathAtom const & at);
///
- void plainInsert(MathAtom const &);
- ///
- void niceInsert(MathAtom const &);
+ void niceInsert(BufferView & bv, std::string const & str);
- ///
- void delLine();
- /// This is in pixels from (maybe?) the top of inset
- void setPos(int, int);
- ///
- void getPos(int & x, int & y);
- ///
- MathAtom & par() const;
+ /// in pixels from top of screen
+ void setScreenPos(BufferView & bv, int x, int y);
+ /// in pixels from top of screen
+ void getScreenPos(BufferView & bv, int & x, int & y) const;
+ /// in pixels from left of screen
+ int targetX(BufferView & bv) const;
/// return the next enclosing grid inset and the cursor's index in it
- MathArrayInset * enclosingArray(idx_type &) const;
- ///
- InsetFormulaBase const * formula();
- ///
- pos_type pos() const;
- ///
- idx_type idx() const;
- ///
- size_type size() const;
- ///
- void interpret(string const &);
- ///
- void interpret(char);
- ///
- bool toggleLimits();
- ///
- // Macro mode methods
- void macroModeClose();
- ///
- bool inMacroMode() const;
-
+ MathGridInset * enclosingGrid(BufferView & bv, idx_type & idx) const;
+ /// go up to enclosing grid
+ void popToEnclosingGrid(BufferView & bv);
+ /// go up to the hull inset
+ void popToEnclosingHull(BufferView & bv);
+ /// go up to the hull inset
+ void popToHere(BufferView & bv, MathInset const * p);
+ /// adjust anchor position after deletions/insertions
+ void adjust(BufferView & bv, pos_type from, difference_type diff);
+ ///
+ InsetFormulaBase * formula() const;
+ /// current offset in the current cell
+ ///
+ bool script(BufferView & bv, bool);
+ ///
+ bool interpret(BufferView & bv, char);
+ /// interpret name a name of a macro
+ void macroModeClose(BufferView & bv);
+ /// are we currently typing the name of a macro?
+ bool inMacroMode(BufferView & bv) const;
+ /// get access to the macro we are currently typing
+ MathUnknownInset * activeMacro(BufferView & bv);
+ /// get access to the macro we are currently typing
+ MathUnknownInset const * activeMacro(BufferView & bv) const;
+ /// are we currently typing '#1' or '#2' or...?
+ bool inMacroArgMode(BufferView & bv) const;
+ /// are we in math mode (1), text mode (-1) or unsure?
+ MathInset::mode_type currentMode(BufferView & bv) const;
+
// Local selection methods
///
bool selection() const;
///
- void selCopy();
+ void selCopy(BufferView & bv);
///
- void selCut();
+ void selCut(BufferView & bv);
///
- void selDel();
+ void selDel(BufferView & bv);
+ /// pastes n-th element of cut buffer
+ void selPaste(BufferView & bv, size_t n);
///
- void selPaste();
+ void selHandle(BufferView & bv, bool);
///
- void selHandle(bool);
+ void selStart(BufferView & bv);
///
- void selStart();
- ///
- void selClear();
- ///
- void selGet(MathArray & ar);
- ///
- void drawSelection(Painter & pain) const;
- ///
- void handleFont(MathTextCodes t);
- ///
- void handleDelim(string const & l, string const & r);
- ///
- void handleNest(MathInset * p);
- /// Splits cells and shifts right part to the next cell
- void splitCell();
- /// Splits line and insert new row of cell
- void breakLine();
- ///
- MathTextCodes getLastCode() const;
- ///
- void pullArg(bool goright);
+ void selClear(BufferView & bv);
+ /// clears or deletes selection depending on lyxrc setting
+ void selClearOrDel(BufferView & bv);
+ /// draws light-blue selection background
+ void drawSelection(PainterInfo & pi) const;
+ /// replace selected stuff with at, placing the former
+ // selection in given cell of atom
+ void handleNest(BufferView & bv, MathAtom const & at, int cell = 0);
+ /// remove this as soon as LyXFunc::getStatus is "localized"
+ std::string getLastCode() const { return "mathnormal"; }
///
bool isInside(MathInset const *) const;
///
- MathTextCodes nextCode() const;
+ char valign(BufferView & bv) const;
///
- char valign() const;
- ///
- char halign() const;
- ///
- col_type col() const;
- ///
- row_type row() const;
+ char halign(BufferView & bv) const;
- /// Make sure cursor position is valid
- void normalize() const;
- ///
- UpdatableInset * asHyperActiveInset() const;
+ /// make sure cursor position is valid
+ void normalize(BufferView & bv);
+ /// mark current cursor trace for redraw
+ void touch();
- /// enter a MathInset
- void push(MathAtom & par);
+ /// enter a MathInset
+ void push(BufferView & bv, MathAtom & par);
/// enter a MathInset from the front
- void pushLeft(MathAtom & par);
+ void pushLeft(BufferView & bv, MathAtom & par);
/// enter a MathInset from the back
- void pushRight(MathAtom & par);
+ void pushRight(BufferView & bv, MathAtom & par);
/// leave current MathInset to the left
- bool popLeft();
+ bool popLeft(BufferView & bv);
/// leave current MathInset to the left
- bool popRight();
+ bool popRight(BufferView & bv);
///
- MathArray & array() const;
+ bool hasPrevAtom(BufferView & bv) const;
///
- MathXArray & xarray() const;
+ bool hasNextAtom(BufferView & bv) const;
///
- bool hasPrevAtom() const;
+ MathAtom const & prevAtom(BufferView & bv) const;
///
- bool hasNextAtom() const;
+ MathAtom & prevAtom(BufferView & bv);
///
- MathAtom const & prevAtom() const;
+ MathAtom const & nextAtom(BufferView & bv) const;
///
- MathAtom & prevAtom();
- ///
- MathAtom const & nextAtom() const;
- ///
- MathAtom & nextAtom();
+ MathAtom & nextAtom(BufferView & bv);
/// returns the selection
- void getSelection(MathCursorPos &, MathCursorPos &) const;
+ void getSelection(BufferView & bv, CursorSlice &, CursorSlice &) const;
/// returns the normalized anchor of the selection
- MathCursorPos normalAnchor() const;
-
- /// path of positions the cursor had to go if it were leving each inset
- std::vector<MathCursorPos> Cursor_;
- /// path of positions the anchor had to go if it were leving each inset
- std::vector<MathCursorPos> Anchor_;
-
- /// reference to the last item of the path
- MathCursorPos & cursor();
- ///
- MathCursorPos const & cursor() const;
+ CursorSlice normalAnchor(BufferView & bv) const;
- ///
+ /// how deep are we nested?
+ unsigned depth(BufferView & bv) const;
+ /// describe the situation
+ std::string info(BufferView & bv) 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();
-
- ///
- friend class Selection;
+ /// moves on
+ void setSelection(BufferView & bv, CursorBase const & where, size_type n);
+ /// grab selection marked by anchor and current cursor
+ std::string grabSelection(BufferView & bv) const;
+ /// guess what
+ std::string grabAndEraseSelection(BufferView & bv);
+ ///
+ void insert(BufferView & bv, char c);
+ ///
+ void insert(BufferView & bv, std::string const & str);
+ /// lock/unlock inset
+ void insetToggle(BufferView & bv);
+ /// hack for reveal codes
+ void markInsert(BufferView & bv);
+ void markErase(BufferView & bv);
+ /// injects content of a cell into parent
+ void pullArg(BufferView & bv);
+ /// split font inset etc
+ void handleFont(BufferView & bv, std::string const & font);
+ ///
+ DispatchResult dispatch(BufferView & bv, FuncRequest const & cmd);
private:
- /// moves cursor position one cell to the left
- bool posLeft();
- /// moves cursor position one cell to the right
- bool posRight();
/// moves cursor index one cell to the left
- bool idxLeft();
+ bool idxLeft(BufferView & bv);
/// moves cursor index one cell to the right
- bool idxRight();
- /// moves position somehow up
- bool goUp();
- /// moves position somehow down
- bool goDown();
+ bool idxRight(BufferView & bv);
+ /// moves cursor to end of last cell of current line
+ bool idxLineLast(BufferView & bv);
+ /// moves cursor position one cell to the left
+ bool posLeft(BufferView & bv);
+ /// moves cursor position one cell to the right
+ bool posRight(BufferView & bv);
+ /// moves position somehow up or down
+ bool goUpDown(BufferView & bv, bool up);
+ /// moves position closest to (x, y) in given box
+ bool bruteFind(BufferView & bv,
+ int x, int y, int xlow, int xhigh, int ylow, int yhigh);
+ /// moves position closest to (x, y) in current cell
+ void bruteFind2(BufferView & bv, int x, int y);
+ /// are we in a nucleus of a script inset?
+ bool inNucleus(BufferView & bv) const;
- ///
- string macroName() const;
- ///
- int macroNamePos() const;
- ///
- void insert(char, MathTextCodes t);
- /// can we enter the inset?
+ /// erase the selected part and re-sets the cursor
+ void eraseSelection(BufferView & bv);
+
+ /// the name of the macro we are currently inputting
+ std::string macroName(BufferView & bv) const;
+ /// where in the curent cell does the macro name start?
+ difference_type macroNamePos(BufferView & bv) const;
+ /// 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_;
- ///
- MathTextCodes lastcode_;
+ /// pointer to enclsing LyX inset
+ InsetFormulaBase * formula_;
// Selection stuff
+ /// text code of last char entered
+ //MathTextCodes lastcode_;
+ /// do we allow autocorrection
+ bool autocorrect_;
/// do we currently select
bool selection_;
+ /// are we entering a macro name?
+ bool macromode_;
};
extern MathCursor * mathcursor;
+void releaseMathCursor(BufferView & bv);
#endif