4 * This file is part of LyX, the document processor.
5 * Licence details can be found in the file COPYING.
8 * \author Lars Gullik Bjønnes
11 * Full author contact details are available in file CREDITS.
17 #include "bufferview_funcs.h"
19 #include "dispatchresult.h"
20 #include "dimension.h"
23 #include "lyxlayout_ptr_fwd.h"
24 #include "ParagraphList.h"
51 /// This class encapsulates the main text data and operations in LyX
55 explicit LyXText(BufferView * bv = 0);
57 void init(BufferView *);
60 LyXFont getFont(Buffer const & buffer, Paragraph const & par,
63 void applyOuterFont(Buffer const & buffer, LyXFont &) const;
65 LyXFont getLayoutFont(Buffer const & buffer, pit_type pit) const;
67 LyXFont getLabelFont(Buffer const & buffer,
68 Paragraph const & par) const;
70 void setCharFont(Buffer const & buffer, pit_type pit, pos_type pos,
71 LyXFont const & font);
73 void setCharFont(Buffer const & buffer, pit_type pit, pos_type pos,
74 LyXFont const & font, bool toggleall);
76 /// what you expect when pressing <enter> at cursor position
77 void breakParagraph(LCursor & cur, bool keep_layout = false);
79 /// set layout over selection
80 void setLayout(Buffer const & buffer, pit_type start, pit_type end,
81 std::string const & layout);
83 void setLayout(LCursor & cur, std::string const & layout);
85 /// what type of depth change to make
90 /// Increase or decrease the nesting depth of the selected paragraph(s)
91 void changeDepth(LCursor & cur, DEPTH_CHANGE type);
93 /// Returns whether something would be changed by changeDepth
94 bool changeDepthAllowed(LCursor & cur, DEPTH_CHANGE type) const;
96 /// Set font over selection paragraphs and rebreak.
97 void setFont(LCursor & cur, LyXFont const &, bool toggleall = false);
99 /// rebreaks the given par
100 bool redoParagraph(BufferView &, pit_type pit);
102 /// returns pos in given par at given x coord
103 pos_type x2pos(BufferView const &, pit_type pit, int row, int x) const;
104 int pos2x(pit_type pit, pos_type pos) const;
107 void toggleFree(LCursor & cur, LyXFont const &, bool toggleall = false);
110 docstring getStringToIndex(LCursor const & cur);
112 /// insert a character at cursor position
113 void insertChar(LCursor & cur, char_type c);
114 /// insert an inset at cursor position
115 void insertInset(LCursor & cur, InsetBase * inset);
117 /// compute text metrics
118 void metrics(MetricsInfo & mi, Dimension & dim);
119 /// draw text (only used for insets)
120 void draw(PainterInfo & pi, int x, int y) const;
121 /// draw textselection
122 void drawSelection(PainterInfo & pi, int x, int y) const;
124 /// try to handle that request
125 void dispatch(LCursor & cur, FuncRequest & cmd);
126 /// do we want to handle this event?
127 bool getStatus(LCursor & cur, FuncRequest const & cmd,
128 FuncStatus & status) const;
130 /// read-only access to individual paragraph
131 Paragraph const & getPar(pit_type pit) const { return pars_[pit]; }
132 /// read-write access to individual paragraph
133 Paragraph & getPar(pit_type pit) { return pars_[pit]; }
134 // Returns the current font and depth as a message.
135 std::string currentState(LCursor & cur);
137 /** returns row near the specified
138 * y-coordinate in given paragraph (relative to the screen).
140 Row const & getRowNearY(BufferView const & bv, int y,
142 pit_type getPitNearY(BufferView const & bv, int y) const;
144 /** returns the column near the specified x-coordinate of the row
145 x is set to the real beginning of this column
147 pos_type getColumnNearX(BufferView const & bv, pit_type pit,
148 Row const & row, int & x, bool & boundary) const;
150 /** Find the word under \c from in the relative location
151 * defined by \c word_location.
152 * @param from return here the start of the word
153 * @param to return here the end of the word
155 void getWord(CursorSlice & from, CursorSlice & to, word_location const);
156 /// just selects the word the cursor is in
157 void selectWord(LCursor & cur, word_location loc);
159 /// accept selected change
160 void acceptChange(LCursor & cur);
161 /// reject selected change
162 void rejectChange(LCursor & cur);
164 /// returns true if par was empty and was removed
165 bool setCursor(LCursor & cur, pit_type par, pos_type pos,
166 bool setfont = true, bool boundary = false);
168 void setCursor(CursorSlice &, pit_type par, pos_type pos);
170 void setCursorIntern(LCursor & cur, pit_type par,
171 pos_type pos, bool setfont = true, bool boundary = false);
173 void setCurrentFont(LCursor & cur);
176 void recUndo(LCursor & cur, pit_type first, pit_type last) const;
178 void recUndo(LCursor & cur, pit_type first) const;
179 /// returns true if par was empty and was removed
180 bool setCursorFromCoordinates(LCursor & cur, int x, int y);
182 /// sets cursor recursively descending into nested editable insets
184 \return the inset pointer if x,y is covering that inset
185 \param x,y are absolute screen coordinates.
186 \retval inset is non-null if the cursor is positionned inside
188 InsetBase * editXY(LCursor & cur, int x, int y);
190 /// Move cursor one line up.
192 * Returns true if an update is needed after the move.
194 bool cursorUp(LCursor & cur);
195 /// Move cursor one line down.
197 * Returns true if an update is needed after the move.
199 bool cursorDown(LCursor & cur);
200 /// Move cursor one position left
202 * Returns true if an update is needed after the move.
204 bool cursorLeft(LCursor & cur);
205 /// Move cursor one position right
207 * Returns true if an update is needed after the move.
209 bool cursorRight(LCursor & cur);
211 bool cursorLeftOneWord(LCursor & cur);
213 bool cursorRightOneWord(LCursor & cur);
215 bool cursorUpParagraph(LCursor & cur);
217 bool cursorDownParagraph(LCursor & cur);
219 bool cursorHome(LCursor & cur);
221 bool cursorEnd(LCursor & cur);
223 bool cursorPrevious(LCursor & cur);
225 bool cursorNext(LCursor & cur);
227 bool cursorTop(LCursor & cur);
229 bool cursorBottom(LCursor & cur);
230 /// Erase character at cursor. Honour change tracking
231 bool erase(LCursor & cur);
232 /** At cursor position 0, merge paragraph with the one before it.
233 * Ignore CT (this is used in \c acceptChange, \c rejectChange for
234 * physical deletion of paragraph break)
236 bool backspacePos0(LCursor & cur);
237 /// Delete character before cursor. Honour CT
238 bool backspace(LCursor & cur);
239 // Dissolve the inset under cursor
240 bool dissolveInset(LCursor & cur);
242 bool selectWordWhenUnderCursor(LCursor & cur, word_location);
248 text_capitalization = 1,
252 /// Change the case of the word at cursor position.
253 void changeCase(LCursor & cur, TextCase action);
255 /** the DTP switches for paragraphs. LyX will store the top settings
256 always in the first physical paragraph, the bottom settings in the
257 last. When a paragraph is broken, the top settings rest, the bottom
258 settings are given to the new one.
260 void setParagraph(LCursor & cur,
261 Spacing const & spacing,
263 docstring const & labelwidthstring,
266 /* these things are for search and replace */
268 /// needed to insert the selection
269 void insertStringAsLines(LCursor & cur, docstring const & str);
270 /// needed to insert the selection
271 void insertStringAsParagraphs(LCursor & cur, docstring const & str);
273 /// current text width
276 /// current text heigth
279 /// Returns an inset if inset was hit, or 0 if not.
280 InsetBase * checkInsetHit(BufferView const &, int x, int y) const;
283 int singleWidth(Buffer const &, Paragraph const & par,
286 int singleWidth(Paragraph const & par, pos_type pos, char_type c,
287 LyXFont const & Font) const;
289 /// return the color of the canvas
290 LColor_color backgroundColor() const;
293 * Returns the left beginning of the text.
294 * This information cannot be taken from the layout object, because
295 * in LaTeX the beginning of the text fits in some cases
296 * (for example sections) exactly the label-width.
298 int leftMargin(Buffer const &, pit_type pit, pos_type pos) const;
299 int leftMargin(Buffer const &, pit_type pit) const;
301 int rightMargin(Buffer const &, Paragraph const & par) const;
303 /** this calculates the specified parameters. needed when setting
304 * the cursor and when creating a visible row */
305 RowMetrics computeRowMetrics(Buffer const &, pit_type pit,
306 Row const & row) const;
308 /// access to our paragraphs
309 ParagraphList const & paragraphs() const { return pars_; }
310 ParagraphList & paragraphs() { return pars_; }
311 /// return true if this is the main text
312 bool isMainText(Buffer const &) const;
314 /// return first row of text
315 Row const & firstRow() const;
317 /// is this row the last in the text?
318 bool isLastRow(pit_type pit, Row const & row) const;
319 /// is this row the first in the text?
320 bool isFirstRow(pit_type pit, Row const & row) const;
323 double spacing(Buffer const & buffer, Paragraph const & par) const;
324 /// make a suggestion for a label
325 docstring getPossibleLabel(LCursor & cur) const;
326 /// is this paragraph right-to-left?
327 bool isRTL(Buffer const &, Paragraph const & par) const;
329 bool checkAndActivateInset(LCursor & cur, bool front);
332 void write(Buffer const & buf, std::ostream & os) const;
333 /// returns whether we've seen our usual 'end' marker
334 bool read(Buffer const & buf, LyXLex & lex, ErrorList & errorList);
341 int cursorX(Buffer const &, CursorSlice const & cursor,
342 bool boundary) const;
344 int cursorY(CursorSlice const & cursor, bool boundary) const;
346 /// delete double space or empty paragraphs around old cursor
347 bool deleteEmptyParagraphMechanism(LCursor & cur, LCursor & old);
354 /// the current font settings
355 LyXFont current_font;
357 LyXFont real_current_font;
359 int background_color_;
366 /// our 'outermost' font. This is handed down from the surrounding
367 // inset through the pi/mi parameter (pi.base.font)
373 /// return past-the-last paragraph influenced by a layout
375 pit_type undoSpan(pit_type pit);
377 /// Calculate and set the height of the row
378 void setHeightOfRow(BufferView const &, pit_type, Row & row);
380 // fix the cursor `cur' after a characters has been deleted at `where'
381 // position. Called by deleteEmptyParagraphMechanism
382 void fixCursorAfterDelete(CursorSlice & cur, CursorSlice const & where);
385 void deleteWordForward(LCursor & cur);
387 void deleteWordBackward(LCursor & cur);
389 void deleteLineForward(LCursor & cur);
391 /// sets row.end to the pos value *after* which a row should break.
392 /// for example, the pos after which isNewLine(pos) == true
393 void rowBreakPoint(Buffer const &, int right_margin, pit_type pit,
395 /// sets row.width to the minimum space a row needs on the screen in pixel
396 void setRowWidth(Buffer const &, pit_type pit, Row & row) const;
397 /// the minimum space a manual label needs on the screen in pixels
398 int labelFill(Buffer const &, Paragraph const & par, Row const & row) const;
400 int labelEnd(Buffer const &, pit_type pit) const;
404 /// set 'number' font property
405 void number(LCursor & cur);
408 /// return the default height of a row in pixels, considering font zoom
409 int defaultRowHeight();