X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2FCursorSlice.h;h=f6d60d8ce627430d35e2d8468460f43a595abcb2;hb=62af7ee772f16f154225d2d0b65d77f4376b6001;hp=01634bdacca3a1dabc2d507dbb614a9b2df9e40e;hpb=a4e03846cd4a5c369548e0913994e5f482a83277;p=lyx.git diff --git a/src/CursorSlice.h b/src/CursorSlice.h index 01634bdacc..f6d60d8ce6 100644 --- a/src/CursorSlice.h +++ b/src/CursorSlice.h @@ -32,7 +32,7 @@ class Paragraph; /// This encapsulates a single slice of a document iterator as used e.g. /// for cursors. -// After IU, the distinction of MathInset and InsetOld as well as +// After inset unification, the distinction of InsetMath and Inset as well as // that of MathData and Text should vanish. They are conceptually the // same (now...) @@ -65,6 +65,8 @@ public: friend bool operator<=(CursorSlice const &, CursorSlice const &); //@} + /// return true if the slice has not been initialized + bool empty() const { return !inset_; } /// the current inset Inset & inset() const { return *inset_; } /// return the cell this cursor is in @@ -87,7 +89,11 @@ public: pos_type pos() const { return pos_; } /// return the position within the paragraph pos_type & pos() { return pos_; } - /// return the last position within the paragraph + /*! + * \return the last position within the paragraph. + * Note that this is the position behind the last character or inset, + * i.e. you cannot dereference it. + */ pos_type lastpos() const; /// return the number of embedded cells size_t nargs() const { return inset_->nargs(); } @@ -113,6 +119,8 @@ public: Text * text() const { return inset_->getText(idx_); } /// paragraph in this cell Paragraph & paragraph() const; + /// + void setPitPos(pit_type pit, pos_type pos); /// /// mathed specific stuff @@ -132,11 +140,15 @@ public: void forwardIdx(); /// move to previous cell void backwardIdx(); + /// are we at the end of the cell + bool at_cell_end() const; + /// are we at the start of the cell + bool at_cell_begin() const; /// are we at the end of this slice bool at_end() const; /// are we at the start of this slice bool at_begin() const; - + private: /// pointer to 'owning' inset. This is some kind of cache. @@ -146,7 +158,9 @@ private: * Cell index of a position in this inset. * This is the primary cell information also for grid like insets, * although we have the convenience functions row() and col() for - * those * and column changes every time the number of columns ornumber + * those. + * This means that the corresponding idx_ of a cell in a given row + * and column changes every time the number of columns or number * of rows changes. Normally the cursor should stay in the same cell, * so these changes should typically be performed like the following: * \code