// -*- 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
- *
- * Dependencies: Xlib, XForms
+/**
+ * \file math_cursor.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
*
- * Copyright: 1996, Alejandro Aguilar Sierra
+ * \author Alejandro Aguilar Sierra
+ * \author André Pönitz
*
- * 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 "math_inset.h"
-#include "math_pos.h"
-#include "LString.h"
+#include "math_iterator.h"
+#include "support/std_string.h"
class InsetFormulaBase;
-class Painter;
-class Selection;
+class BufferView;
+class PainterInfo;
+class MathUnknownInset;
/**
[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
+World. It contains a stack of CursorPos, 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.
+this formula's MathHullInset to the current position.
*/
public:
/// short of anything else reasonable
typedef MathInset::size_type size_type;
+ /// type for column numbers
+ typedef MathArray::difference_type difference_type;
/// type for cursor positions within a cell
typedef MathInset::pos_type pos_type;
/// type for cell indices
typedef MathInset::row_type row_type;
/// type for column numbers
typedef MathInset::col_type col_type;
- /// how to store a cursor
- typedef std::vector<MathCursorPos> cursor_type;
///
explicit MathCursor(InsetFormulaBase *, bool left);
///
+ ~MathCursor();
+ ///
void insert(MathAtom const &);
///
void insert(MathArray const &);
///
- void paste(MathArray const &);
- ///
- void erase();
+ void insert2(string const &);
///
- void backspace();
+ void paste(string const & data);
+ /// return false for empty math insets
+ bool erase();
+ /// return false for empty math insets
+ bool backspace();
/// called for LFUN_HOME etc
- void home(bool sel = false);
+ bool home(bool sel = false);
/// called for LFUN_END etc
- void end(bool sel = false);
+ bool end(bool sel = false);
/// called for LFUN_RIGHT and LFUN_RIGHTSEL
bool right(bool sel = false);
/// called for LFUN_LEFT etc
void plainInsert(MathAtom const &);
///
void niceInsert(MathAtom const &);
-
///
- void delLine();
+ void niceInsert(string const &);
+
/// in pixels from top of screen
void setPos(int x, int y);
/// in pixels from top of screen
- void getPos(int & x, int & y);
+ void getPos(int & x, int & y) const;
+ /// in pixels from left of screen
+ int targetX() const;
/// current inset
- MathInset * par() const;
+ MathInset * inset() const;
/// return the next enclosing grid inset and the cursor's index in it
- MathGridInset * enclosingGrid(idx_type &) const;
- ///
- InsetFormulaBase * formula();
+ MathGridInset * enclosingGrid(idx_type & idx) const;
+ /// go up to enclosing grid
+ void popToEnclosingGrid();
+ /// go up to the hull inset
+ void popToEnclosingHull();
+ /// go up to the hull inset
+ void popToHere(MathInset const * p);
+ /// adjust anchor position after deletions/insertions
+ void adjust(pos_type from, difference_type diff);
+ ///
+ InsetFormulaBase * formula() const;
/// current offset in the current cell
pos_type pos() const;
/// current cell
///
bool script(bool);
///
- bool interpret(string const &);
- ///
bool interpret(char);
- ///
- bool toggleLimits();
/// interpret name a name of a macro
void macroModeClose();
- ///
+ /// are we currently typing the name of a macro?
bool inMacroMode() const;
-
+ /// get access to the macro we are currently typing
+ MathUnknownInset * activeMacro();
+ /// get access to the macro we are currently typing
+ MathUnknownInset const * activeMacro() const;
+ /// are we currently typing '#1' or '#2' or...?
+ bool inMacroArgMode() const;
+ /// are we in math mode (1), text mode (-1) or unsure?
+ MathInset::mode_type currentMode() const;
+
// Local selection methods
///
bool selection() const;
void selCut();
///
void selDel();
- ///
- void selPaste();
+ /// pastes n-th element of cut buffer
+ void selPaste(size_t n);
///
void selHandle(bool);
///
void selStart();
///
void selClear();
+ /// clears or deletes selection depending on lyxrc setting
+ void selClearOrDel();
+ /// draws light-blue selection background
+ void drawSelection(PainterInfo & pi) const;
///
- 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();
- /// read contents of line into an array
- void readLine(MathArray & ar) const;
+ void handleNest(MathAtom const & at);
/// remove this as soon as LyXFunc::getStatus is "localized"
- MathTextCodes getLastCode() const { return lastcode_; }
- ///
- void pullArg(bool goright);
+ string getLastCode() const { return "mathnormal"; }
///
bool isInside(MathInset const *) const;
///
- MathTextCodes nextCode() const;
- ///
char valign() const;
///
char halign() const;
- ///
- col_type hullCol() const;
- ///
- row_type hullRow() const;
- ///
- col_type gridCol() const;
- ///
- row_type gridRow() const;
/// make sure cursor position is valid
void normalize();
+ /// mark current cursor trace for redraw
+ void touch();
///
UpdatableInset * asHyperActiveInset() const;
- /// enter a MathInset
+ /// enter a MathInset
void push(MathAtom & par);
/// enter a MathInset from the front
void pushLeft(MathAtom & par);
///
MathArray & array() const;
///
- MathXArray & xarray() const;
- ///
bool hasPrevAtom() const;
///
bool hasNextAtom() const;
MathAtom & nextAtom();
/// returns the selection
- void getSelection(MathCursorPos &, MathCursorPos &) const;
+ void getSelection(CursorPos &, CursorPos &) 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
- cursor_type Cursor_;
- /// path of positions the anchor had to go if it were leving each inset
- mutable cursor_type Anchor_;
+ CursorPos normalAnchor() const;
/// reference to the last item of the path, i.e. "The Cursor"
- MathCursorPos & cursor();
+ CursorPos & cursor();
/// reference to the last item of the path, i.e. "The Cursor"
- MathCursorPos const & cursor() const;
+ CursorPos const & cursor() const;
+ /// how deep are we nested?
+ unsigned depth() const;
+ /// local dispatcher
+ dispatch_result dispatch(FuncRequest const & cmd);
+ /// describe the situation
+ string info() 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);
+ /// moves on
+ void setSelection(MathIterator const & where, size_type n);
+ /// grab selection marked by anchor and current cursor
+ string grabSelection() const;
+ /// guess what
+ string grabAndEraseSelection();
+ ///
+ void insert(char c);
+ ///
+ void insert(string const & str);
+ /// lock/unlock inset
+ void insetToggle();
- ///
- friend class Selection;
+ /// hack for reveal codes
+ void markInsert();
+ void markErase();
+ /// injects content of a cell into parent
+ void pullArg();
+ /// split font inset etc
+ void handleFont(string const & font);
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();
/// moves cursor index one cell to the right
bool idxRight();
+ /// moves cursor to end of last cell of current line
+ bool idxLineLast();
+ /// moves cursor position one cell to the left
+ bool posLeft();
+ /// moves cursor position one cell to the right
+ bool posRight();
/// 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);
+ /// 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() const;
- ///
+ /// erase the selected part and re-sets the cursor
+ void eraseSelection();
+
+ /// the name of the macro we are currently inputting
string macroName() const;
- ///
- MathInset::difference_type macroNamePos() const;
- ///
- void insert(char, MathTextCodes t);
- /// can we enter the inset?
+ /// where in the curent cell does the macro name start?
+ difference_type macroNamePos() const;
+ /// can we enter the inset?
bool openable(MathAtom const &, bool selection) const;
/// write access to cursor cell position
pos_type & pos();
/// write access to cursor cell index
idx_type & idx();
- ///
+ /// path of positions the cursor had to go if it were leaving each inset
+ MathIterator Cursor_;
+ /// path of positions the anchor had to go if it were leaving each inset
+ mutable MathIterator Anchor_;
+ /// pointer to enclsing LyX inset
InsetFormulaBase * formula_;
- ///
- MathTextCodes lastcode_;
// 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_;
+ /// are we targeting a certain x coordinate, if so, which one?
+ int targetx_;
};
extern MathCursor * mathcursor;
+void releaseMathCursor(BufferView * bv);
#endif