X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2FRow.h;h=156fd9f671eefb166af633ebb99f1d6609b6aa85;hb=9ce0ff50c1a96b276fa1a74f358718bf571f3dfb;hp=426f45edcc10cba3d377f1271fbdcb6009bbaa72;hpb=ff7cdf1b74f5c17a966af24dc70d49fc162f007e;p=features.git diff --git a/src/Row.h b/src/Row.h index 426f45edcc..156fd9f671 100644 --- a/src/Row.h +++ b/src/Row.h @@ -18,6 +18,7 @@ #include "Changes.h" #include "Dimension.h" #include "Font.h" +#include "RowFlags.h" #include "support/docstring.h" #include "support/types.h" @@ -49,7 +50,10 @@ public: // An inset INSET, // Some spacing described by its width, not a string - SPACE + SPACE, + // Spacing until the left margin, with a minimal value given + // by the initial width + MARGINSPACE }; /** @@ -57,12 +61,10 @@ public: * by other methods that need to parse the Row contents. */ struct Element { + // Element(Type const t, pos_type p, Font const & f, Change const & ch) - : type(t), pos(p), endpos(p + 1), inset(0), - extra(0), font(f), change(ch), final(false) {} + : type(t), pos(p), endpos(p + 1), font(f), change(ch) {} - // Return the number of separator in the element (only STRING type) - int countSeparators() const; // Return total width of element, including separator overhead // FIXME: Cache this value or the number of expanders? @@ -86,24 +88,32 @@ public: * adjusted to the actual pixel position. */ pos_type x2pos(int &x) const; - /** Break the element if possible, so that its width is less - * than \param w. Returns true on success. When \param force - * is true, the string is cut at any place, other wise it - * respects the row breaking rules of characters. + /** Break the element in two if possible, so that its width is less + * than the required values. + * \return true if something has been done ; false if this is + * not needed or not possible. + * \param width: maximum width of the row. + * \param next_width: available width on next rows. + * \param force: if true, cut string at any place, even for + * languages that wrap at word delimiters; if false, do not + * break at all if first element would larger than \c width. + * \param tail: a vector of elements where the remainder of + * the text will be appended (empty if nothing happened). */ - bool breakAt(int w, bool force); - - // Returns the position on left side of the element. - pos_type left_pos() const; - // Returns the position on right side of the element. - pos_type right_pos() const; + // FIXME: ideally last parameter should be Elements&, but it is not possible. + bool splitAt(int width, int next_width, bool force, std::vector & tail); + // remove trailing spaces (useful for end of row) + void rtrim(); // bool isRTL() const { return font.isVisibleRightToLeft(); } // This is true for virtual elements. - // Note that we do not use the type here. The two definitions - // should be equivalent - bool isVirtual() const { return pos == endpos; } + bool isVirtual() const { return type == VIRTUAL; } + + // Returns the position on left side of the element. + pos_type left_pos() const { return isRTL() ? endpos : pos; }; + // Returns the position on right side of the element. + pos_type right_pos() const { return isRTL() ? pos : endpos; }; // The kind of row element Type type; @@ -111,15 +121,17 @@ public: pos_type pos; // first position after the element in the paragraph pos_type endpos; - // The dimension of the chunk (does not contains the + // The dimension of the chunk (does not contain the // separator correction) Dimension dim; + // The width of the element without trailing spaces + int nspc_wid = 0; // Non-zero only if element is an inset - Inset const * inset; + Inset const * inset = nullptr; // Only non-null for justified rows - double extra; + double extra = 0; // Non-empty if element is a string or is virtual docstring str; @@ -128,14 +140,19 @@ public: // Change change; // is it possible to add contents to this element? - bool final; + bool final = false; + // properties with respect to row breaking (made of RowFlag enumerators) + int row_flags = Inline; friend std::ostream & operator<<(std::ostream & os, Element const & row); }; + /// + typedef Element value_type; /// - Row(); + Row() {} + /** * Helper function: set variable \c var to value \c val, and mark * row as changed is the values were different. This is intended @@ -189,9 +206,9 @@ public: /// pos_type endpos() const { return end_; } /// - void right_boundary(bool b) { right_boundary_ = b; } + void end_boundary(bool b) { end_boundary_ = b; } /// - bool right_boundary() const { return right_boundary_; } + bool end_boundary() const { return end_boundary_; } /// void flushed(bool b) { flushed_ = b; } /// @@ -209,18 +226,17 @@ public: int ascent() const { return dim_.asc; } /// int descent() const { return dim_.des; } + /// - int totalAscent() const { return ascent() + top_padding; } + Dimension const & contents_dim() const { return contents_dim_; } /// - int totalDescent() const { return dim_.des + bottom_padding; } + Dimension & contents_dim() { return contents_dim_; } /// The offset of the left-most cursor position on the row int left_x() const; /// The offset of the right-most cursor position on the row int right_x() const; - // Return the number of separators in the row - int countSeparators() const; // Set the extra spacing for every expanding character in STRING-type // elements. \param w is the total amount of extra width for the row to be // distributed among expanders. \return false if the justification fails. @@ -231,12 +247,14 @@ public: Font const & f, Change const & ch); /// void add(pos_type pos, char_type const c, - Font const & f, Change const & ch); + Font const & f, Change const & ch); /// void addVirtual(pos_type pos, docstring const & s, Font const & f, Change const & ch); /// void addSpace(pos_type pos, int width, Font const & f, Change const & ch); + /// + void addMarginSpace(pos_type pos, int width, Font const & f, Change const & ch); /// typedef std::vector Elements; @@ -263,18 +281,19 @@ public: Element & back() { return elements_.back(); } /// Element const & back() const { return elements_.back(); } - /// remove last element + /// add element at the end and update width + void push_back(Element const &); + /// remove last element and update width void pop_back(); /** * if row width is too large, remove all elements after last * separator and update endpos if necessary. If all that * remains is a large word, cut it to \param width. - * \param body_pos minimum amount of text to keep. * \param width maximum width of the row. - * \param available width on next row. - * \return true if the row has been shortened. + * \param next_width available width on next row. + * \return list of elements remaining after breaking. */ - bool shortenIfNeeded(pos_type const body_pos, int const width, int const next_width); + Elements shortenIfNeeded(int const width, int const next_width); /** * If last element of the row is a string, compute its width @@ -286,10 +305,12 @@ public: * Find sequences of right-to-left elements and reverse them. * This should be called once the row is completely built. */ - void reverseRTL(bool rtl_par); + void reverseRTL(); /// bool isRTL() const { return rtl_; } /// + void setRTL(bool rtl) { rtl_ = rtl; } + /// bool needsChangeBar() const { return changebar_; } /// void needsChangeBar(bool ncb) { changebar_ = ncb; } @@ -300,25 +321,21 @@ public: friend std::ostream & operator<<(std::ostream & os, Row const & row); /// additional width for separators in justified rows (i.e. space) - double separator; + double separator = 0; /// width of hfills in the label - double label_hfill; + double label_hfill = 0; /// the left margin position of the row - int left_margin; + int left_margin = 0; /// the right margin of the row - int right_margin; - /// possible padding above the row - int top_padding; - /// possible padding below the row - int bottom_padding; + int right_margin = 0; /// - mutable pos_type sel_beg; + mutable pos_type sel_beg = -1; /// - mutable pos_type sel_end; + mutable pos_type sel_end = -1; /// - mutable bool begin_margin_sel; + mutable bool begin_margin_sel = false; /// - mutable bool end_margin_sel; + mutable bool end_margin_sel = false; private: /// Decides whether the margin is selected. @@ -343,25 +360,36 @@ private: Elements elements_; /// has the Row appearance changed since last drawing? - mutable bool changed_; + mutable bool changed_ = true; /// Index of the paragraph that contains this row - pit_type pit_; + pit_type pit_ = 0; /// first pos covered by this row - pos_type pos_; + pos_type pos_ = 0; /// one behind last pos covered by this row - pos_type end_; + pos_type end_ = 0; // Is there a boundary at the end of the row (display inset...) - bool right_boundary_; + bool end_boundary_ = false; // Shall the row be flushed when it is supposed to be justified? - bool flushed_; + bool flushed_ = false; /// Row dimension. Dimension dim_; + /// Row contents dimension. Does not contain the space above/below row. + Dimension contents_dim_; /// true when this row lives in a right-to-left paragraph - bool rtl_; + bool rtl_ = false; /// true when a changebar should be drawn in the margin - bool changebar_; + bool changebar_ = false; }; +std::ostream & operator<<(std::ostream & os, Row::Elements const & elts); + + +/** + * Each paragraph is broken up into a number of rows on the screen. + * This is a list of such on-screen rows, ordered from the top row + * downwards. + */ +typedef std::vector RowList; } // namespace lyx