lyx_mirror/src/mathed/math_inset.h
André Pönitz fda98080cc cosmetics
git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@2353 a592a061-630c-0410-9148-cb99ea01b6c8
2001-07-26 06:56:43 +00:00

238 lines
6.2 KiB
C++

// -*- C++ -*-
/*
* File: math_inset.h
* Purpose: Declaration of insets for mathed
* Author: Alejandro Aguilar Sierra <asierra@servidor.unam.mx>
* Created: January 1996
* Description: Math paragraph and objects for a WYSIWYG math editor.
*
* Dependencies: Xlib, XForms
*
* Copyright: 1996, 1997 Alejandro Aguilar Sierra
*
* Version: 0.8beta, Math & Lyx project.
*
* You are free to use and modify this code under the terms of
* the GNU General Public Licence version 2 or later.
*/
// Note: These math insets are internal to Math and are not derived
// from lyx inset.
#ifndef MATH_INSET_H
#define MATH_INSET_H
#include <config.h>
#ifdef __GNUG__
#pragma interface
#endif
#include "LString.h"
#include "symbol_def.h"
#include "xarray.h"
/** Abstract base class for all math objects.
A math insets is for use of the math editor only, it isn't a
general LyX inset. It's used to represent all the math objects.
The formulaInset (a LyX inset) encapsulates a math inset.
*/
class LaTeXFeatures;
class MathInset {
public:
///
explicit MathInset
(int na = 0, string const & nm = string(), MathInsetTypes ot = LM_OT_SIMPLE);
/// the virtual base destructor
virtual ~MathInset() {}
/// draw the object, sets xo_ and yo_ cached values
virtual void draw(Painter &, int x, int baseline) = 0;
/// write LaTeX and Lyx code
virtual void write(std::ostream &, bool fragile) const = 0;
/// write normalized content
virtual void writeNormal(std::ostream &) const;
/// reproduce itself
virtual MathInset * clone() const = 0;
/// appends itself with macro arguments substituted
virtual void substitute(MathArray & array, MathMacro const & macro) const;
/// compute the size of the object, sets ascend_, descend_ and width_
virtual void metrics(MathStyles st) = 0;
///
virtual int ascent() const;
///
virtual int descent() const;
///
virtual int width() const;
///
virtual int height() const;
///
virtual int limits() const;
///
virtual void limits(int);
///
string const & name() const;
///
MathInsetTypes getType() const;
///
MathInsetTypes GetType() const { return getType(); }
//Man: Avoid to use these functions if it's not strictly necessary
///
virtual void setType(MathInsetTypes t);
///
virtual void setName(string const & n);
///
MathStyles size() const;
/// Where should we go when we press the up cursor key?
virtual bool idxUp(int & idx, int & pos) const;
/// The down key
virtual bool idxDown(int & idx, int & pos) const;
/// The left key
virtual bool idxLeft(int & idx, int & pos) const;
/// The right key
virtual bool idxRight(int & idx, int & pos) const;
/// Move one physical cell up
virtual bool idxNext(int & idx, int & pos) const;
/// Move one physical cell down
virtual bool idxPrev(int & idx, int & pos) const;
/// Target pos when we enter the inset from the left by pressing "Right"
virtual bool idxFirst(int & idx, int & pos) const;
/// Target pos when we enter the inset from the left by pressing "Up"
virtual bool idxFirstUp(int & idx, int & pos) const;
/// Target pos when we enter the inset from the left by pressing "Down"
virtual bool idxFirstDown(int & idx, int & pos) const;
/// Target pos when we enter the inset from the right by pressing "Left"
virtual bool idxLast(int & idx, int & pos) const;
/// Target pos when we enter the inset from the right by pressing "Up"
virtual bool idxLastUp(int & idx, int & pos) const;
/// Target pos when we enter the inset from the right by pressing "Down"
virtual bool idxLastDown(int & idx, int & pos) const;
/// Where should we go if we press home?
virtual bool idxHome(int & idx, int & pos) const;
/// Where should we go if we press end?
virtual bool idxEnd(int & idx, int & pos) const;
/// Delete a cell and move cursor
// the return value indicates whether the cursor should leave the inset
// and/or the whole inset should be deleted
virtual void idxDelete(int & idx, bool & popit, bool & deleteit);
// deletes a cell range and moves the cursor
virtual void idxDeleteRange(int from, int to);
// returns list of cell indices that are "between" from and to for
// selction purposes
virtual std::vector<int> idxBetween(int from, int to) const;
///
int nargs() const;
///
MathArray & cell(int);
///
MathArray const & cell(int) const;
///
MathXArray & xcell(int);
///
MathXArray const & xcell(int) const;
///
int xo() const;
///
int yo() const;
///
void xo(int tx);
///
void yo(int ty);
///
///
virtual int ncols() const { return 1; }
///
virtual int nrows() const { return 1; }
///
virtual int col(int) const { return 0; }
///
virtual int row(int) const { return 0; }
///
virtual void addRow(int) {}
///
virtual void delRow(int) {}
///
virtual void addCol(int) {}
///
virtual void delCol(int) {}
///
virtual void userSetSize(MathStyles &) {}
///
void getXY(int & x, int & y) const;
///
bool covers(int x, int y) const;
/// Identifies things that can get scripts
virtual bool isScriptable() const { return false; }
/// Identifies ScriptInsets
virtual bool isScriptInset() const { return false; }
/// Identifies SpaceInsets
virtual bool isSpaceInset() const { return false; }
///
virtual bool isActive() const { return nargs() > 0; }
///
void push_back(MathInset *);
///
void push_back(unsigned char ch, MathTextCodes fcode);
///
void dump() const;
///
void validate(LaTeXFeatures & features) const;
///
static int workwidth;
protected:
/// usually the LaTeX name of the thingy
string name_;
///
MathInsetTypes objtype;
/// the width of this inset as computed by metrics()
int width_;
///
int ascent_;
///
int descent_;
///
void size(MathStyles s);
/// the used font size
MathStyles size_;
protected:
///
typedef std::vector<MathXArray> cells_type;
/**
* The contents of the inset are contained here.
* Each inset is build from a number of insets.
*/
cells_type cells_;
private:
/// the following are used for positioning the cursor with the mouse
/// cached cursor start position in pixels from the document left
int xo_;
/// cached cursor start position in pixels from the document top
int yo_;
};
std::ostream & operator<<(std::ostream &, MathInset const &);
#endif