]> git.lyx.org Git - lyx.git/blobdiff - src/lyxtext.h
Alfredo's second patch
[lyx.git] / src / lyxtext.h
index bdf8fe980b2ec19bcaa99213c9d9d16582369416..7e44bfb02ce1c21cc425cecbb0a62628554ba846 100644 (file)
@@ -1,13 +1,15 @@
 // -*- C++ -*-
-/* This file is part of
- * ======================================================
- *
- *           LyX, The Document Processor
+/**
+ * \file lyxtext.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
  *
- *           Copyright 1995 Matthias Ettrich
- *           Copyright 1995-2001 The LyX Team.
+ * \author unknown
+ * \author Lars Gullik Bjønnes
+ * \author John Levon
  *
- * ====================================================== */
+ * Full author contact details are available in file CREDITS
+ */
 
 #ifndef LYXTEXT_H
 #define LYXTEXT_H
@@ -17,6 +19,8 @@
 #include "layout.h"
 #include "LColor.h"
 #include "insets/inset.h"
+#include "RowList.h"
+#include "bufferview_funcs.h"
 
 class Buffer;
 class BufferParams;
@@ -37,18 +41,13 @@ class ParagraphList;
 class LyXText {
 public:
        /// what repainting is needed
-       enum text_status {
+       enum refresh_status {
                /// no repaint is needed
-               UNCHANGED = 0,
-               /**
-                * A paint has caused a change in some rows
-                * and rebreaking is needed.
-                */
-               CHANGED_IN_DRAW = 1,
+               REFRESH_NONE = 0,
                /// the refresh_row needs repainting
-               NEED_VERY_LITTLE_REFRESH = 2,
+               REFRESH_ROW = 1,
                /// everything from refresh_y downwards needs repainting
-               NEED_MORE_REFRESH = 3
+               REFRESH_AREA = 2
        };
 
        ///
@@ -71,32 +70,32 @@ public:
        /// sets inset as owner
        LyXText(BufferView *, InsetText *);
 
-       /// Destructor
-       ~LyXText();
-
        void init(BufferView *, bool reinit = false);
        ///
-       mutable int height;
+       int height;
        ///
-       mutable unsigned int width;
+       unsigned int width;
        /// the current font settings
-       mutable LyXFont current_font;
+       LyXFont current_font;
        /// the current font
-       mutable LyXFont real_current_font;
+       LyXFont real_current_font;
 private:
-       /** the first visible row on screen
-        *  declared mutable because removeRow is const
+       /** the 'anchor' row: the position of this row remains constant
+        *  with respect to the top of the screen
         */
-       mutable Row * top_row_;
+       RowList::iterator anchor_row_;
        /** the pixel offset with respect to this row of top_y
-        *  declared mutable because removeRow is const
         */
-       mutable int top_row_offset_;
+       int anchor_row_offset_;
 public:
+       /// update all cached row positions
+       void updateRowPositions();
        /// get the y coord. of the top of the screen (relative to doc start)
        int top_y() const;
-       /// set it
+       /// set the y coord. of the top of the screen (relative to doc start)
        void top_y(int newy);
+       /// set the anchoring row. top_y will be computed relative to this
+       void anchor_row(RowList::iterator rit);
        ///
        InsetText * inset_owner;
        ///
@@ -105,43 +104,43 @@ public:
        ///
        int getRealCursorX() const;
        ///
-       LyXFont const getFont(Buffer const *, Paragraph * par,
+       LyXFont const getFont(Buffer const *, ParagraphList::iterator pit,
                lyx::pos_type pos) const;
        ///
-       LyXFont const getLayoutFont(Buffer const *, Paragraph * par) const;
+       LyXFont const getLayoutFont(Buffer const *,
+                                   ParagraphList::iterator pit) const;
        ///
-       LyXFont const getLabelFont(Buffer const *, Paragraph * par) const;
+       LyXFont const getLabelFont(Buffer const *,
+                                  ParagraphList::iterator pit) const;
        ///
-       void setCharFont(Buffer const *, Paragraph * par,
+       void setCharFont(Buffer const *, ParagraphList::iterator pit,
                         lyx::pos_type pos, LyXFont const & font);
-       void setCharFont(Paragraph * par,
-                        lyx::pos_type pos, LyXFont const & font, bool toggleall);
+       void setCharFont(ParagraphList::iterator pit,
+                        lyx::pos_type pos,
+                        LyXFont const & font, bool toggleall);
 
-       /// return true if the row changed
-       void markChangeInDraw(Row * row, Row * next);
        ///
-       void breakAgainOneRow(Row * row);
+       void breakAgainOneRow(RowList::iterator rit);
        /// what you expect when pressing <enter> at cursor position
        void breakParagraph(ParagraphList & paragraphs, char keep_layout = 0);
 
        /** set layout over selection and make a total rebreak of
          those paragraphs
          */
-       Paragraph * setLayout(LyXCursor & actual_cursor,
-                             LyXCursor & selection_start,
-                             LyXCursor & selection_end,
-                             string const & layout);
+       ParagraphList::iterator
+       setLayout(LyXCursor & actual_cursor,
+                 LyXCursor & selection_start,
+                 LyXCursor & selection_end,
+                 string const & layout);
        ///
        void setLayout(string const & layout);
 
-       /** increment depth over selection and make a total rebreak of those
-         paragraphs
-         */
-       void incDepth();
-
-       /** decrement depth over selection and make a total rebreak of those
-         paragraphs */
-       void decDepth();
+       /**
+        * Increase or decrease the nesting depth of the selected paragraph(s)
+        * if test_only, don't change any depths. Returns whether something
+        * (would have) changed
+        */
+       bool changeDepth(bv_funcs::DEPTH_CHANGE type, bool test_only);
 
        /// get the depth at current cursor position
        int getDepth() const;
@@ -158,9 +157,9 @@ public:
          This function is needed after SetLayout and SetFont etc.
          */
        void redoParagraphs(LyXCursor const & cursor,
-                           Paragraph const * end_par) const;
+                           ParagraphList::iterator endpit);
        ///
-       void redoParagraph() const;
+       void redoParagraph();
 
        ///
        void toggleFree(LyXFont const &, bool toggleall = false);
@@ -185,14 +184,11 @@ public:
        void fullRebreak();
 
        ///
-       mutable Row * need_break_row;
+       RowList::iterator need_break_row;
 
        /// clear any pending paints
        void clearPaint();
 
-       /// post notice that we changed during a draw
-       void postChangedInDraw();
-
        /**
         * Mark position y as the starting point for a repaint
         */
@@ -201,7 +197,7 @@ public:
        /**
         * Mark the given row at position y as needing a repaint.
         */
-       void postRowPaint(Row * row, int start_y);
+       void postRowPaint(RowList::iterator rit, int start_y);
 
        ///
        Inset::RESULT dispatch(FuncRequest const & cmd);
@@ -216,26 +212,25 @@ public:
         * Return the status. This represents what repaints are
         * pending after some operation (e.g. inserting a char).
         */
-       text_status status() const;
+       refresh_status refreshStatus() const;
 
 private:
        /**
         * The pixel y position from which to repaint the screen.
         * The position is absolute along the height of outermost
-        * lyxtext (I think). NEED_MORE_REFRESH and NEED_LITTLE_REFRESH
+        * lyxtext (I think). REFRESH_AREA and REFRESH_ROW
         * repaints both use this as a starting point (if it's within
         * the viewable portion of the lyxtext).
         */
        int refresh_y;
        /**
         * The row from which to repaint the screen, used by screen.c.
-        * This must be set if the pending update is NEED_LITTLE_REFRESH.
-        * It doesn't make any difference for NEED_MORE_REFRESH.
+        * This must be set if the pending update is REFRESH_ROW.
+        * It doesn't make any difference for REFRESH_AREA.
         */
-       mutable Row * refresh_row;
+       RowList::iterator refresh_row;
 
-       /// refresh status
-       text_status status_;
+       refresh_status refresh_status_;
 
        /// only the top-level LyXText has this non-zero
        BufferView * bv_owner;
@@ -245,23 +240,23 @@ public:
          (relative to the whole text). y is set to the real beginning
          of this row
          */
-       Row * getRowNearY(int & y) const;
+       RowList::iterator getRowNearY(int & y) const;
 
        /** returns the column near the specified x-coordinate of the row
         x is set to the real beginning of this column
         */
-       lyx::pos_type getColumnNearX(Row * row,
-                                           int & x, bool & boundary) const;
+       lyx::pos_type getColumnNearX(RowList::iterator rit,
+                                    int & x, bool & boundary) const;
 
        /** returns a pointer to a specified row. y is set to the beginning
         of the row
         */
-       Row * getRow(Paragraph * par, lyx::pos_type pos, int & y) const;
-       /** returns the firstrow, this could be done with the above too but
-           IMO it's stupid to have to allocate a dummy y all the time I need
-           the first row
-       */
-       Row * firstRow() { return firstrow; }
+       RowList::iterator
+       getRow(ParagraphList::iterator pit, lyx::pos_type pos, int & y) const;
+
+       RowList & rows() const {
+               return rowlist_;
+       }
 
        /** The cursor.
          Later this variable has to be removed. There should be now internal
@@ -272,7 +267,7 @@ public:
          Since the LyXText now has been moved from Buffer to BufferView
          it should not be absolutely needed to move the cursor...
          */
-       mutable LyXCursor cursor; // actual cursor position
+       LyXCursor cursor; // actual cursor position
 
        /** The structure that keeps track of the selections set. */
        struct Selection {
@@ -300,27 +295,27 @@ public:
                bool mark_; // former mark_set
 
        };
-       mutable Selection selection;
+       Selection selection;
        // this is used to handle XSelection events in the right manner
-       mutable Selection xsel_cache;
+       Selection xsel_cache;
 
        /// needed for the toggling (cursor position on last selection made)
-       mutable LyXCursor last_sel_cursor;
+       LyXCursor last_sel_cursor;
        /// needed for toggling the selection in screen.C
-       mutable LyXCursor toggle_cursor;
+       LyXCursor toggle_cursor;
        /// needed for toggling the selection in screen.C
-       mutable LyXCursor toggle_end_cursor;
+       LyXCursor toggle_end_cursor;
 
        /// need the selection cursor:
        void setSelection();
        ///
-       void clearSelection() const;
+       void clearSelection();
        ///
        string const selectionAsString(Buffer const *, bool label) const;
 
        /// select the word we need depending on word_location
        void getWord(LyXCursor & from, LyXCursor & to,
-                    word_location const) const;
+                    word_location const);
        /// just selects the word the cursor is in
        void selectWord(word_location const);
        /// returns the inset at cursor (if it exists), 0 otherwise
@@ -337,69 +332,67 @@ public:
         to the beginning of this word.
         With SelectSelectedWord can this be highlighted really
         */
-       WordLangTuple const selectNextWordToSpellcheck(float & value) const;
+       WordLangTuple const selectNextWordToSpellcheck(float & value);
        ///
        void selectSelectedWord();
        /// returns true if par was empty and was removed
-       bool setCursor(Paragraph * par,
+       bool setCursor(ParagraphList::iterator pit,
                       lyx::pos_type pos,
                       bool setfont = true,
-                      bool boundary = false) const;
+                      bool boundary = false);
        ///
-       void setCursor(LyXCursor &, Paragraph * par,
+       void setCursor(LyXCursor &, ParagraphList::iterator pit,
                       lyx::pos_type pos,
-                      bool boundary = false) const;
+                      bool boundary = false);
        ///
-       void setCursorIntern(Paragraph * par,
+       void setCursorIntern(ParagraphList::iterator pit,
                             lyx::pos_type pos,
                             bool setfont = true,
-                            bool boundary = false) const;
+                            bool boundary = false);
        ///
-       void setCurrentFont() const;
+       void setCurrentFont();
 
        ///
-       bool isBoundary(Buffer const *, Paragraph * par,
+       bool isBoundary(Buffer const *, Paragraph const & par,
                        lyx::pos_type pos) const;
        ///
-       bool isBoundary(Buffer const *, Paragraph * par,
+       bool isBoundary(Buffer const *, Paragraph const & par,
                         lyx::pos_type pos,
                         LyXFont const & font) const;
 
        ///
-       void setCursorFromCoordinates(int x, int y) const;
+       void setCursorFromCoordinates(int x, int y);
        ///
        void setCursorFromCoordinates(LyXCursor &,
-                                     int x, int y) const;
+                                     int x, int y);
        ///
-       void cursorUp(bool selecting = false) const;
+       void cursorUp(bool selecting = false);
        ///
-       void cursorDown(bool selecting = false) const;
+       void cursorDown(bool selecting = false);
        ///
-       void cursorLeft(bool internal = true) const;
+       void cursorLeft(bool internal = true);
        ///
-       void cursorRight(bool internal = true) const;
+       void cursorRight(bool internal = true);
        ///
-       void cursorLeftOneWord() const;
+       void cursorLeftOneWord();
        ///
-       void cursorRightOneWord() const;
+       void cursorRightOneWord();
        ///
-       void cursorUpParagraph() const;
+       void cursorUpParagraph();
        ///
-       void cursorDownParagraph() const;
+       void cursorDownParagraph();
        ///
-       void cursorHome() const;
+       void cursorHome();
        ///
-       void cursorEnd() const;
+       void cursorEnd();
        ///
        void cursorPrevious();
        ///
        void cursorNext();
        ///
-       void cursorTab() const;
-       ///
-       void cursorTop() const;
+       void cursorTop();
        ///
-       void cursorBottom() const;
+       void cursorBottom();
        ///
        void Delete();
        ///
@@ -417,8 +410,6 @@ public:
        };
        /// Change the case of the word at cursor position.
        void changeCase(TextCase action);
-       ///
-       void transposeChars();
 
        ///
        void toggleInset();
@@ -428,10 +419,6 @@ public:
        void copySelection();
        ///
        void pasteSelection();
-       ///
-       void copyEnvironmentType();
-       ///
-       void pasteEnvironmentType();
 
        /** the DTP switches for paragraphs. LyX will store the top settings
         always in the first physical paragraph, the bottom settings in the
@@ -468,7 +455,7 @@ public:
 
        /// Find next inset of some specified type.
        bool gotoNextInset(std::vector<Inset::Code> const & codes,
-                          string const & contents = string()) const;
+                          string const & contents = string());
        ///
        void gotoInset(std::vector<Inset::Code> const & codes,
                       bool same_content);
@@ -481,56 +468,30 @@ public:
        /// returns false if inset wasn't found
        bool updateInset(Inset *);
        ///
-       void checkParagraph(Paragraph * par, lyx::pos_type pos);
+       void checkParagraph(ParagraphList::iterator pit, lyx::pos_type pos);
        ///
        int workWidth() const;
        ///
        int workWidth(Inset * inset) const;
-       ///
-       void computeBidiTables(Buffer const *, Row * row) const;
 
+       ///
+       void computeBidiTables(Buffer const *, RowList::iterator row) const;
        /// Maps positions in the visual string to positions in logical string.
-       inline
-       lyx::pos_type log2vis(lyx::pos_type pos) const {
-               if (bidi_start == -1)
-                       return pos;
-               else
-                       return log2vis_list[pos-bidi_start];
-       }
-
+       lyx::pos_type log2vis(lyx::pos_type pos) const;
        /// Maps positions in the logical string to positions in visual string.
-       inline
-       lyx::pos_type vis2log(lyx::pos_type pos) const {
-               if (bidi_start == -1)
-                       return pos;
-               else
-                       return vis2log_list[pos-bidi_start];
-       }
+       lyx::pos_type vis2log(lyx::pos_type pos) const;
        ///
-       inline
-       lyx::pos_type bidi_level(lyx::pos_type pos) const {
-               if (bidi_start == -1)
-                       return 0;
-               else
-                       return bidi_levels[pos-bidi_start];
-       }
+       lyx::pos_type bidi_level(lyx::pos_type pos) const;
        ///
-       inline
-       bool bidi_InRange(lyx::pos_type pos) const {
-               return bidi_start == -1 ||
-                       (bidi_start <= pos && pos <= bidi_end);
-       }
+       bool bidi_InRange(lyx::pos_type pos) const;
 private:
        ///
-       mutable Row * firstrow;
-       ///
-       mutable Row * lastrow;
-
+       mutable RowList rowlist_;
        ///
-       void cursorLeftOneWord(LyXCursor &) const;
+       void cursorLeftOneWord(LyXCursor &);
 
        ///
-       float getCursorX(Row *, lyx::pos_type pos,
+       float getCursorX(RowList::iterator rit, lyx::pos_type pos,
                         lyx::pos_type last, bool boundary) const;
        /// used in setlayout
        void makeFontEntriesLayoutSpecific(Buffer const &, Paragraph & par);
@@ -540,58 +501,50 @@ private:
            */
        void redoDrawingOfParagraph(LyXCursor const & cursor);
 
-       /** Copybuffer for copy environment type.
-         Asger has learned that this should be a buffer-property instead
-         Lgb has learned that 'char' is a lousy type for non-characters
-         */
-       string copylayouttype;
-
-       /** inserts a new row behind the specified row, increments
-           the touched counters */
-       void insertRow(Row * row, Paragraph * par, lyx::pos_type pos) const;
        /// removes the row and reset the touched counters
-       void removeRow(Row * row) const;
+       void removeRow(RowList::iterator rit);
 
        /// remove all following rows of the paragraph of the specified row.
-       void removeParagraph(Row * row) const;
+       void removeParagraph(RowList::iterator rit);
 
        /// insert the specified paragraph behind the specified row
-       void insertParagraph(Paragraph * par, Row * row) const;
+       void insertParagraph(ParagraphList::iterator pit,
+                            RowList::iterator rowit);
 
        /** appends  the implizit specified paragraph behind the specified row,
         * start at the implizit given position */
-       void appendParagraph(Row * row) const;
+       void appendParagraph(RowList::iterator rowit);
 
        ///
-       void breakAgain(Row * row) const;
+       void breakAgain(RowList::iterator rit);
        /// Calculate and set the height of the row
-       void setHeightOfRow(Row * row_ptr) const;
+       void setHeightOfRow(RowList::iterator rit);
 
        // fix the cursor `cur' after a characters has been deleted at `where'
        // position. Called by deleteEmptyParagraphMechanism
        void fixCursorAfterDelete(LyXCursor & cur,
-                                 LyXCursor const & where) const;
+                                 LyXCursor const & where);
 
        /// delete double space (false) or empty paragraphs (true) around old_cursor
-       bool deleteEmptyParagraphMechanism(LyXCursor const & old_cursor) const;
+       bool deleteEmptyParagraphMechanism(LyXCursor const & old_cursor);
 
 public:
        /** Updates all counters starting BEHIND the row. Changed paragraphs
         * with a dynamic left margin will be rebroken. */
-       void updateCounters() const;
+       void updateCounters();
        ///
-       void update(bool changed = true);
+       void update();
        /**
         * Returns an inset if inset was hit, or 0 if not.
         * If hit, the coordinates are changed relative to the inset.
         */
-       Inset * checkInsetHit(int & x, int & y) const;
+       Inset * checkInsetHit(int & x, int & y);
 
        ///
-       int singleWidth(Paragraph * par,
+       int singleWidth(ParagraphList::iterator pit,
                lyx::pos_type pos) const;
        ///
-       int singleWidth(Paragraph * par,
+       int singleWidth(ParagraphList::iterator pit,
                lyx::pos_type pos, char c) const;
 
        /// return the color of the canvas
@@ -600,7 +553,7 @@ public:
        ///
        mutable bool bidi_same_direction;
 
-       unsigned char transformChar(unsigned char c, Paragraph * par,
+       unsigned char transformChar(unsigned char c, Paragraph const & par,
                                    lyx::pos_type pos) const;
 
        /**
@@ -609,13 +562,13 @@ public:
         * in LaTeX the beginning of the text fits in some cases
         * (for example sections) exactly the label-width.
         */
-       int leftMargin(Row const * row) const;
+       int leftMargin(Row const & row) const;
        ///
        int rightMargin(Buffer const &, Row const & row) const;
 
        /** this calculates the specified parameters. needed when setting
         * the cursor and when creating a visible row */
-       void prepareToPrint(Row * row, float & x,
+       void prepareToPrint(RowList::iterator row, float & x,
                            float & fill_separator,
                            float & fill_hfill,
                            float & fill_label_hfill,
@@ -623,7 +576,7 @@ public:
 
 private:
        ///
-       void setCounter(Buffer const *, Paragraph * par) const;
+       void setCounter(Buffer const *, ParagraphList::iterator pit);
        ///
        void deleteWordForward();
        ///
@@ -641,7 +594,7 @@ private:
        lyx::pos_type rowBreakPoint(Row const & row) const;
 
        /// returns the minimum space a row needs on the screen in pixel
-       int fill(Row & row, int workwidth) const;
+       int fill(RowList::iterator row, int workwidth) const;
 
        /**
         * returns the minimum space a manual label needs on the
@@ -654,16 +607,12 @@ private:
 
        ///
        mutable std::vector<lyx::pos_type> log2vis_list;
-
        ///
        mutable std::vector<lyx::pos_type> vis2log_list;
-
        ///
        mutable std::vector<lyx::pos_type> bidi_levels;
-
        ///
        mutable lyx::pos_type bidi_start;
-
        ///
        mutable lyx::pos_type bidi_end;
 
@@ -673,11 +622,7 @@ public:
        //
        // special owner functions
        ///
-       Paragraph * ownerParagraph() const;
-       //
-       void ownerParagraph(Paragraph *) const;
-       // set it searching first for the right owner using the paragraph id
-       void ownerParagraph(int id, Paragraph *) const;
+       ParagraphList & ownerParagraphs() const;
 
        /// return true if this is owned by an inset.
        bool isInInset() const;