3 * \file ParagraphMetrics.h
4 * This file is part of LyX, the document processor.
5 * Licence details can be found in the file COPYING.
7 * \author Asger Alstrup
8 * \author Lars Gullik Bjønnes
10 * \author André Pönitz
11 * \author Jürgen Vigna
12 * \author Abdelrazak Younes
14 * Full author contact details are available in file CREDITS.
17 #ifndef PARAGRAPH_METRICS_H
18 #define PARAGRAPH_METRICS_H
20 #include "Dimension.h"
29 * Each paragraph is broken up into a number of rows on the screen.
30 * This is a list of such on-screen rows, ordered from the top row
33 typedef std::vector<Row> RowList;
44 /// Helper class for paragraph metrics.
45 class ParagraphMetrics {
47 /// Default constructor (only here for STL containers).
48 ParagraphMetrics() : position_(0), par_(0) {}
49 /// The only useful constructor.
50 explicit ParagraphMetrics(Paragraph const & par);
53 ParagraphMetrics & operator=(ParagraphMetrics const &);
55 void reset(Paragraph const & par);
58 Row & getRow(pos_type pos, bool boundary);
60 Row const & getRow(pos_type pos, bool boundary) const;
62 size_t pos2row(pos_type pos) const;
64 /// BufferView::redoParagraph updates this
65 Dimension const & dim() const { return dim_; }
66 Dimension & dim() { return dim_; }
67 /// total height of paragraph
68 int height() const { return dim_.height(); }
69 /// total width of paragraph, may differ from workwidth
70 int width() const { return dim_.width(); }
71 /// ascend of paragraph above baseline
72 int ascent() const { return dim_.ascent(); }
73 /// descend of paragraph below baseline
74 int descent() const { return dim_.descent(); }
75 /// Text updates the rows using this access point
76 RowList & rows() { return rows_; }
77 /// The painter and others use this
78 RowList const & rows() const { return rows_; }
80 int rightMargin(BufferView const & bv) const;
82 /// dump some information to lyxerr
86 bool hfillExpansion(Row const & row, pos_type pos) const;
89 size_t computeRowSignature(Row const &, BufferView const & bv) const;
92 int position() const { return position_; }
93 void setPosition(int position);
99 mutable RowList rows_;
100 /// cached dimensions of paragraph
103 Paragraph const * par_;
108 #endif // PARAGRAPH_METRICS_H