X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Fundo.h;h=9275e0e48cc2ed4cba96dc4fac8b3e9cd1d75381;hb=e94889a041628203c50b66b9a4add63210de6928;hp=33ed9c34db773b68f3d53ee13578639d754d82bf;hpb=5c2f0c5c4642d9302a9bb7d19327a7dc4539f079;p=lyx.git diff --git a/src/undo.h b/src/undo.h index 33ed9c34db..9275e0e48c 100644 --- a/src/undo.h +++ b/src/undo.h @@ -16,108 +16,120 @@ #ifndef UNDO_H #define UNDO_H -#include "ParagraphList_fwd.h" +#include "dociterator.h" +#include "ParagraphList.h" +#include "bufferparams.h" + #include "support/types.h" -class LyXText; +#include + +class BufferParams; class BufferView; +class LCursor; + /** - * These are the elements put on the undo stack. Each object - * contains complete paragraphs and sufficient information - * to restore the state. - */ +These are the elements put on the undo stack. Each object contains complete +paragraphs from some cell and sufficient information to restore the cursor +state. + +The cell is given by a DocIterator pointing to this cell, the 'interesting' +range of paragraphs by counting them from begin and end of cell, +respectively. + +The cursor is also given as DocIterator and should point to some place in +the stored paragraph range. In case of math, we simply store the whole +cell, as there usually is just a simple paragraph in a cell. + +The idea is to store the contents of 'interesting' paragraphs in some +structure ('Undo') _before_ it is changed in some edit operation. +Obviously, the stored ranged should be as small as possible. However, it +there is a lower limit: The StableDocIterator pointing stored in the undo +class must be valid after the changes, too, as it will used as a pointer +where to insert the stored bits when performining undo. + +*/ + class Undo { public: - /** - * The undo kinds are used to combine consecutive undo recordings - * of the same kind. - */ + /// This is used to combine consecutive undo recordings of the same kind. enum undo_kind { /** * Insert something - these will combine to one big chunk * when many inserts come after each other. */ INSERT, - /** * Delete something - these will combine to one big chunk * when many deletes come after each other. */ DELETE, - /// Atomic - each of these will have its own entry in the stack ATOMIC }; - /// - Undo(undo_kind kind, int text, - int first, int last, - int cursor, int cursor_pos, - ParagraphList const & par_arg); /// Which kind of operation are we recording for? undo_kind kind; - - /// hosting LyXText counted from buffer begin - int text; - - /// Offset to the first paragraph in the main document paragraph list - int first_par_offset; - - /// Offset to the last paragraph from the end of the main par. list - int last_par_offset; - - /** - * Offset from the start of the main document paragraph list, - * except if inside an inset, in which case it's the offset - * inside the hosting inset. - */ - int cursor_par_offset; - - /// The position of the cursor in the hosting paragraph - int cursor_pos; - - /// The contents of the paragraphs saved + /// the position of the cursor + StableDocIterator cursor; + /// the position of the cell described + StableDocIterator cell; + /// counted from begin of cell + lyx::pit_type from; + /// complement to end of this cell + lyx::pit_type end; + /// the contents of the saved Paragraphs (for texted) ParagraphList pars; + /// the stringified contents of the saved MathArray (for mathed) + std::string array; + /// Only used in case of full backups + BufferParams bparams; + /// Only used in case of full backups + bool isFullBuffer; }; -/// This will undo the last action - returns false if no undo possible -bool textUndo(BufferView *); +/// this will undo the last action - returns false if no undo possible +bool textUndo(BufferView & bv); -/// This will redo the last undo - returns false if no redo possible -bool textRedo(BufferView *); +/// this will redo the last undo - returns false if no redo possible +bool textRedo(BufferView & bv); -/// Makes sure the next operation will be stored +/// makes sure the next operation will be stored void finishUndo(); -/** - * Whilst undo is frozen, all actions do not get added - * to the undo stack - */ -void freezeUndo(); - -/// Track undos again -void unFreezeUndo(); /** - * Record undo information - call with the first paragraph that will be changed - * and the last paragraph that will be changed. So we give an inclusive - * range. + * Record undo information - call with the current cursor and the 'other + * end' of the range of changed paragraphs. So we give an inclusive range. * This is called before you make the changes to the paragraph, and it * will record the original information of the paragraphs in the undo stack. + * + * FIXME: We need something to record undo in partial grids for mathed. + * Right now we use recordUndoInset if more than one cell is changed, + * but that puts the cursor in front of the inset after undo. We would need + * something like + * recordUndoGrid(LCursor & cur, Undo::undo_kind kind, idx_type from, idx_type to); + * and store the cell information in class Undo. */ -void recordUndo(Undo::undo_kind kind, - LyXText const * text, lyx::paroffset_type first, lyx::paroffset_type last); -/// Convienience: Prepare undo when change in a single paragraph. -void recordUndo(Undo::undo_kind kind, - LyXText const * text, lyx::paroffset_type par); +/// The general case: prepare undo for an arbitrary range. +void recordUndo(LCursor & cur, Undo::undo_kind kind, + lyx::pit_type from, lyx::pit_type to); + +/// Convenience: prepare undo for the range between 'from' and cursor. +void recordUndo(LCursor & cur, Undo::undo_kind kind, lyx::pit_type from); -/// Convienience: Prepare undo for the paragraph that contains the cursor -void recordUndo(BufferView *, Undo::undo_kind kind); +/// Convenience: prepare undo for the single paragraph or cell +/// containing the cursor +void recordUndo(LCursor & cur, Undo::undo_kind kind = Undo::ATOMIC); +/// Convenience: prepare undo for the inset containing the cursor +void recordUndoInset(LCursor & cur, Undo::undo_kind kind = Undo::ATOMIC); +/// Convenience: prepare undo for the selected paragraphs +void recordUndoSelection(LCursor & cur, Undo::undo_kind kind = Undo::ATOMIC); -/// Are we avoiding tracking undos currently ? -extern bool undo_frozen; +/// Convenience: prepare undo for the whole buffer +void recordUndoFullDocument(BufferView * bv); #endif // UNDO_FUNCS_H