X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2FCursorSlice.h;h=308b938455f55cc0d4ea4b47d435f65ae8444a78;hb=f1ae30919f4925b91a069d12060aa7588c4586bf;hp=d703cb4b3479ac3198c26ea3ed2df0dfaeb82f32;hpb=e52a38549328a58b6fe8efeecef21a71fb9c8d65;p=lyx.git diff --git a/src/CursorSlice.h b/src/CursorSlice.h index d703cb4b34..308b938455 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 @@ -150,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