src/insets/insettabular.h

   1 // -*- C++ -*-
   2 /**
   3  * \file insettabular.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author Jürgen Vigna
   8  *
   9  * Full author contact details are available in file CREDITS.
  10  */
  11 // This is the rewrite of the tabular (table) support.
  12
  13 // It will probably be a lot of work.
  14
  15 // One first goal could be to make the inset read the old table format
  16 // and just output it again... no viewing at all.
  17
  18 // When making the internal structure of tabular support I really think
  19 // that STL containers should be used. This will separate the container from
  20 // the rest of the code, which is a good thing.
  21
  22 // Ideally the tabular support should do as the mathed and use
  23 // LaTeX in the .lyx file too.
  24
  25 // Things to think of when desingning the new tabular support:
  26 // - color support (colortbl, color)
  27 // - decimal alignment (dcloumn)
  28 // - custom lines (hhline)
  29 // - rotation
  30 // - multicolumn
  31 // - multirow
  32 // - column styles
  33
  34 // This is what I have written about tabular support in the LyX3-Tasks file:
  35 //
  36 //  o rewrite of table code. Should probably be written as some
  37 //          kind of an inset. At least get the code out of the kernel.
  38 //                - colortbl  -multirow
  39 //                - hhline    -multicolumn
  40 //                - dcolumn
  41 // o enhance longtable support
  42
  43 // Lgb
  44
  45 #ifndef INSETTABULAR_H
  46 #define INSETTABULAR_H
  47
  48 #include "inset.h"
  49 #include "tabular.h"
  50 #include "frontends/mouse_state.h"
  51
  52 class FuncStatus;
  53 class LyXLex;
  54 class Painter;
  55 class BufferView;
  56 class Buffer;
  57 class BufferParams;
  58 class Paragraph;
  59
  60 class InsetTabular : public UpdatableInset {
  61 public:
  62         ///
  63         InsetTabular(Buffer const &, int rows = 1, int columns = 1);
  64         ///
  65         InsetTabular(InsetTabular const &);
  66         ///
  67         ~InsetTabular();
  68         ///
  69         virtual std::auto_ptr<InsetBase> clone() const;
  70         ///
  71         void read(Buffer const &, LyXLex &);
  72         ///
  73         void write(Buffer const &, std::ostream &) const;
  74         ///
  75         void metrics(MetricsInfo &, Dimension &) const;
  76         ///
  77         void draw(PainterInfo & pi, int x, int y) const;
  78         ///
  79         std::string const editMessage() const;
  80         //
  81         void insetUnlock(BufferView *);
  82         ///
  83         void updateLocal(BufferView *) const;
  84         ///
  85         bool lockInsetInInset(BufferView *, UpdatableInset *);
  86         ///
  87         bool unlockInsetInInset(BufferView *, UpdatableInset *,
  88                                 bool lr = false);
  89         ///
  90         int insetInInsetY() const;
  91         ///
  92         UpdatableInset * getLockingInset() const;
  93         ///
  94         UpdatableInset * getFirstLockingInsetOfType(InsetOld::Code);
  95         ///
  96         bool insertInset(BufferView *, InsetOld *);
  97         ///
  98         bool insetAllowed(InsetOld::Code code) const;
  99         ///
 100         bool isTextInset() const { return true; }
 101         /** returns true if, when outputing LaTeX, font changes should
 102             be closed before generating this inset. This is needed for
 103             insets that may contain several paragraphs */
 104         bool noFontChange() const { return true; }
 105         ///
 106         bool display() const { return tabular.isLongTabular(); }
 107         ///
 108         int latex(Buffer const &, std::ostream &,
 109                   LatexRunParams const &) const;
 110         ///
 111         int ascii(Buffer const &, std::ostream &,
 112                   LatexRunParams const &) const;
 113         ///
 114         int linuxdoc(Buffer const &, std::ostream &,
 115                      LatexRunParams const &) const;
 116         ///
 117         int docbook(Buffer const &, std::ostream &,
 118                     LatexRunParams const &) const;
 119         ///
 120         void validate(LaTeXFeatures & features) const;
 121         ///
 122         InsetOld::Code lyxCode() const { return InsetOld::TABULAR_CODE; }
 123         /// FIXME, document
 124         void getCursorPos(BufferView *, int & x, int & y) const;
 125         /// Get the absolute document x,y of the cursor
 126         virtual void getCursor(BufferView &, int &, int &) const;
 127         ///
 128         bool tabularFeatures(BufferView * bv, std::string const & what);
 129         ///
 130         void tabularFeatures(BufferView * bv, LyXTabular::Feature feature,
 131                              std::string const & val = std::string());
 132         ///
 133         int getActCell() const { return actcell; }
 134         ///
 135         void setFont(BufferView *, LyXFont const &, bool toggleall = false,
 136                      bool selectall = false);
 137         ///
 138         LyXText * getLyXText(BufferView const *,
 139                              bool const recursive = false) const;
 140         ///
 141         void deleteLyXText(BufferView *, bool recursive = true) const;
 142         ///
 143         void openLayoutDialog(BufferView *) const;
 144         ///
 145         bool showInsetDialog(BufferView *) const;
 146         ///
 147         FuncStatus getStatus(std::string const & argument) const;
 148         /// Appends \c list with all labels found within this inset.
 149         void getLabelList(Buffer const &, std::vector<std::string> & list) const;
 150         ///
 151         int scroll(bool recursive=true) const;
 152         ///
 153         void scroll(BufferView *bv, float sx) const {
 154                 UpdatableInset::scroll(bv, sx);
 155         }
 156         ///
 157         void scroll(BufferView *bv, int offset) const {
 158                 UpdatableInset::scroll(bv, offset);
 159         }
 160         ///
 161         ParagraphList * getParagraphs(int) const;
 162         ///
 163         int numParagraphs() const;
 164         ///
 165         LyXText * getText(int) const;
 166         ///
 167         LyXCursor const & cursor(BufferView *) const;
 168         ///
 169         bool allowSpellcheck() const { return true; }
 170         ///
 171         WordLangTuple const
 172         selectNextWordToSpellcheck(BufferView *, float & value) const;
 173         ///
 174         void selectSelectedWord(BufferView *);
 175
 176         void markErased();
 177
 178         /// find next change
 179         bool nextChange(BufferView *, lyx::pos_type & length);
 180         ///
 181         bool searchForward(BufferView *, std::string const &,
 182                            bool = true, bool = false);
 183         bool searchBackward(BufferView *, std::string const &,
 184                             bool = true, bool = false);
 185
 186         // this should return true if we have a "normal" cell, otherwise true.
 187         // "normal" means without width set!
 188         bool forceDefaultParagraphs(InsetOld const * in) const;
 189
 190         ///
 191         void addPreview(lyx::graphics::PreviewLoader &) const;
 192
 193         //
 194         // Public structures and variables
 195         ///
 196         mutable LyXTabular tabular;
 197
 198         /// are some cells selected ?
 199         bool hasSelection() const {
 200                 return has_selection;
 201         }
 202
 203         ///
 204         virtual BufferView * view() const;
 205         ///
 206         Buffer const & buffer() const;
 207
 208         /// set the owning buffer
 209         void buffer(Buffer * buf);
 210 protected:
 211         ///
 212         virtual
 213         DispatchResult
 214         priv_dispatch(FuncRequest const &, idx_type &, pos_type &);
 215 private:
 216         /// lock cell with given index
 217         void edit(BufferView * bv, int index);
 218         ///
 219         void lfunMousePress(FuncRequest const &);
 220         ///
 221         // the bool return is used to see if we opened a dialog so that we can
 222         // check this from an outer inset and open the dialog of the outer inset
 223         // if that one has one!
 224         ///
 225         bool lfunMouseRelease(FuncRequest const &);
 226         ///
 227         void lfunMouseMotion(FuncRequest const &);
 228         ///
 229         void calculate_dimensions_of_cells(MetricsInfo & mi) const;
 230         ///
 231         void drawCellLines(Painter &, int x, int baseline,
 232                            int row, int cell) const;
 233         ///
 234         void drawCellSelection(Painter &, int x, int baseline,
 235                                int row, int column, int cell) const;
 236         ///
 237         void fitInsetCursor(BufferView *) const;
 238         ///
 239         void setPos(BufferView *, int x, int y) const;
 240         ///
 241         DispatchResult moveRight(BufferView *, bool lock = true);
 242         ///
 243         DispatchResult moveLeft(BufferView *, bool lock = true);
 244         ///
 245         DispatchResult moveUp(BufferView *, bool lock = true);
 246         ///
 247         DispatchResult moveDown(BufferView *, bool lock = true);
 248         ///
 249         bool moveNextCell(BufferView *, bool lock = false);
 250         ///
 251         bool movePrevCell(BufferView *, bool lock = false);
 252         ///
 253         int getCellXPos(int cell) const;
 254         ///
 255         void resetPos(BufferView *) const;
 256         ///
 257         void removeTabularRow();
 258         ///
 259         void clearSelection() const {
 260                 sel_cell_start = sel_cell_end = 0;
 261                 has_selection = false;
 262         }
 263         void setSelection(int start, int end) const {
 264                 sel_cell_start = start;
 265                 sel_cell_end = end;
 266                 has_selection = true;
 267         }
 268         ///
 269         bool activateCellInset(BufferView *, int x = 0, int y = 0,
 270                                mouse_button::state button = mouse_button::none,
 271                                bool behind = false);
 272         ///
 273         bool insetHit(BufferView * bv, int x, int y) const;
 274         ///
 275         bool hasPasteBuffer() const;
 276         ///
 277         bool copySelection(BufferView *);
 278         ///
 279         bool pasteSelection(BufferView *);
 280         ///
 281         bool cutSelection(BufferParams const & bp);
 282         ///
 283         bool isRightToLeft(BufferView *);
 284         ///
 285         void getSelection(int & scol, int & ecol,
 286                           int & srow, int & erow) const;
 287         ///
 288         WordLangTuple selectNextWordInt(BufferView *, float & value) const;
 289         ///
 290         bool insertAsciiString(BufferView *, std::string const & buf, bool usePaste);
 291
 292         //
 293         // Private structures and variables
 294         ///
 295         InsetText * the_locking_inset;
 296         ///
 297         InsetText * old_locking_inset;
 298         ///
 299         Buffer const * buffer_;
 300         ///
 301         mutable int cursorx_;
 302         ///
 303         mutable int cursory_;
 304         ///
 305         mutable unsigned int inset_x;
 306         ///
 307         mutable unsigned int inset_y;
 308         /// true if a set of cells are selected
 309         mutable bool has_selection;
 310         /// the starting cell selection nr
 311         mutable int sel_cell_start;
 312         /// the ending cell selection nr
 313         mutable int sel_cell_end;
 314         ///
 315         mutable int actcell;
 316         ///
 317         mutable int oldcell;
 318         ///
 319         mutable int actcol;
 320         ///
 321         mutable int actrow;
 322         ///
 323         mutable int first_visible_cell;
 324         ///
 325         bool no_selection;
 326         ///
 327         mutable bool locked;
 328         ///
 329         mutable int in_reset_pos;
 330 };
 331
 332
 333 #include "mailinset.h"
 334
 335
 336 class InsetTabularMailer : public MailInset {
 337 public:
 338         ///
 339         InsetTabularMailer(InsetTabular const & inset);
 340         ///
 341         virtual InsetBase & inset() const { return inset_; }
 342         ///
 343         virtual std::string const & name() const { return name_; }
 344         ///
 345         virtual std::string const inset2string(Buffer const &) const;
 346         /// Returns the active cell if successful, else -1.
 347         static int string2params(std::string const &, InsetTabular &);
 348         ///
 349         static std::string const params2string(InsetTabular const &);
 350 private:
 351         ///
 352         static std::string const name_;
 353         ///
 354         InsetTabular & inset_;
 355 };
 356
 357 std::string const featureAsString(LyXTabular::Feature feature);
 358
 359 #endif