// -*- C++ -*-
/**
* \file BufferView.h
- * Copyright 2002 the LyX Team
- * Read the file COPYING
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
*
- * \author Lars Gullik Bjønnes
-*/
+ * \author Alfredo Braustein
+ * \author Lars Gullik Bjønnes
+ * \author John Levon
+ * \author Jürgen Vigna
+ *
+ * Full author contact details are available in file CREDITS.
+ */
#ifndef BUFFER_VIEW_H
#define BUFFER_VIEW_H
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include "metricsinfo.h"
-#include "LString.h"
-#include "undo.h"
+#include "frontends/LyXKeySym.h"
-#include "insets/inset.h"
+#include "support/types.h"
#include <boost/utility.hpp>
-class LyXView;
-class LyXText;
-class TeXErrors;
+#include <string>
+
class Buffer;
-class LyXScreen;
+class Change;
+class DocIterator;
+class FuncRequest;
+class FuncStatus;
class Language;
-class Painter;
-class UpdatableInset;
-class WordLangTuple;
+class LCursor;
+class LyXText;
+class LyXView;
+class ParIterator;
+class ViewMetricsInfo;
+
+namespace Update {
+ enum flags {
+ FitCursor = 1,
+ Force = 2,
+ SinglePar = 4,
+ MultiParSel = 8
+ };
+
+inline flags operator|(flags const f, flags const g)
+{
+ return static_cast<flags>(int(f) | int(g));
+}
+
+inline flags operator&(flags const f, flags const g)
+{
+ return static_cast<flags>(int(f) & int(g));
+}
+
+} // namespace
+
+/// Scrollbar Parameters
+struct ScrollbarParameters
+{
+ void reset(int h = 0, int p = 0, int l = 0)
+ {
+ height = h;
+ position = p;
+ lineScrollHeight = l;
+ }
+
+ /// The total document height in pixels
+ int height;
+ /// The current position in the document, in pixels
+ int position;
+ /// the line-scroll amount, in pixels
+ int lineScrollHeight;
+};
-///
+/**
+ * A buffer view encapsulates a view onto a particular
+ * buffer, and allows access to operate upon it. A view
+ * is a sliding window of the entire document rendering.
+ *
+ * Eventually we will allow several views onto a single
+ * buffer, but not yet.
+ */
class BufferView : boost::noncopyable {
public:
- ///
- enum UpdateCodes {
- ///
- UPDATE = 0,
- ///
- SELECT = 1,
- ///
- FITCUR = 2,
- ///
- CHANGE = 4
- };
+ /**
+ * Create a view with the given owner main window,
+ * of the given dimensions.
+ */
+ BufferView(LyXView * owner);
- ///
- BufferView(LyXView * owner, int , int , int, int);
- ///
~BufferView();
- ///
+
+ /// set the buffer we are viewing
+ void setBuffer(Buffer * b);
+ /// return the buffer being viewed
Buffer * buffer() const;
- ///
- Painter & painter() const;
- ///
- LyXScreen & screen() const;
- ///
- void buffer(Buffer * b);
- ///
+ /// return the first layout of the Buffer.
+ std::string firstLayout();
+
+ /// return the owning main view
+ LyXView * owner() const;
+
+ /// resize event has happened
void resize();
- /**
- * Repaint the pixmap. Used for when we don't want
- * to go through the full update() logic, just a simple
- * repaint of the whole screen.
+
+ /// reload the contained buffer
+ void reload();
+ /// load a buffer into the view
+ bool loadLyXFile(std::string const & name, bool tolastfiles = true);
+
+ /** perform pending painting updates. \c fitcursor means first
+ * to do a fitcursor, and to force an update if screen
+ * position changes. \c forceupdate means to force an update
+ * in any case.
+ * \return true if a full updateMetrics() is needed.
*/
- void repaint();
- ///
+ bool update(Update::flags flags = Update::FitCursor | Update::Force);
+
+ /// move the screen to fit the cursor. Only to be called with
+ /// good y coordinates (after a bv::metrics)
bool fitCursor();
- ///
- void update();
- //
- void update(LyXText *, UpdateCodes uc);
- ///
+ /// reset the scrollbar to reflect current view position
void updateScrollbar();
- ///
- void redoCurrentBuffer();
- ///
+ /// return the Scrollbar Parameters
+ ScrollbarParameters const & scrollbarParameters() const;
+
+ /// FIXME
bool available() const;
- ///
- LyXView * owner() const;
- ///
- void beforeChange(LyXText *);
- ///
+
+ /// Save the current position as bookmark i
void savePosition(unsigned int i);
- ///
+ /// Restore the position from bookmark i
void restorePosition(unsigned int i);
- ///
+ /// does the given bookmark have a saved position ?
bool isSavedPosition(unsigned int i);
- /** This holds the mapping between buffer paragraphs and screen rows.
- This should be private...but not yet. (Lgb)
- */
- LyXText * text;
- ///
- LyXText * getLyXText() const;
- ///
- LyXText * getParentText(Inset * inset) const;
- ///
- Language const * getParentLanguage(Inset * inset) const;
- ///
- int workWidth() const;
- ///
- UpdatableInset * theLockingInset() const;
- ///
- void theLockingInset(UpdatableInset * inset);
- ///
- void updateInset(Inset * inset, bool mark_dirty);
- ///
- int slx;
- ///
- int sly;
- ///
- void insetUnlock();
- ///
- void replaceWord(string const & replacestring);
- ///
- void endOfSpellCheck();
- ///
- void selectLastWord();
- /// return the next word
- WordLangTuple const nextWord(float & value);
- ///
- bool gotoLabel(string const & label);
- ///
- void pasteEnvironment();
- ///
- void copyEnvironment();
- ///
- void menuUndo();
- ///
- void menuRedo();
- /// removes all autodeletable insets
- bool removeAutoInsets();
- ///
- void insertErrors(TeXErrors & terr);
- ///
+ /// save bookmarks to .lyx/session
+ void saveSavedPositions();
+
+ /// return the current change at the cursor
+ Change const getCurrentChange();
+
+ /// return the lyxtext we are using
+ LyXText * getLyXText();
+
+ /// return the lyxtext we are using
+ LyXText const * getLyXText() const;
+
+ /// move cursor to the named label
+ void gotoLabel(std::string const & label);
+
+ /// set the cursor based on the given TeX source row
void setCursorFromRow(int row);
- /** Insert an inset into the buffer.
- Place it in a layout of lout,
- if no_table make sure that it doesn't end up in a table.
- */
- bool insertInset(Inset * inset, string const & lout = string());
- /// Inserts a lyx file at cursor position. return #false# if it fails
- bool insertLyXFile(string const & file);
- ///
- bool lockInset(UpdatableInset * inset);
- ///
- void showLockedInsetCursor(int x, int y, int asc, int desc);
- ///
- void hideLockedInsetCursor();
- ///
- bool fitLockedInsetCursor(int x, int y, int asc, int desc);
- ///
- int unlockInset(UpdatableInset * inset);
- ///
- void lockedInsetStoreUndo(Undo::undo_kind kind);
- ///
- void showCursor();
- ///
- void hideCursor();
- ///
- void toggleSelection(bool = true);
- ///
- void toggleToggle();
- ///
+
+ /// center the document view around the cursor
void center();
/// scroll document by the given number of lines of default height
void scroll(int lines);
-
/// Scroll the view by a number of pixels
- void scrollDocView(int);
+ void scrollDocView(int pixels);
+ /// Set the cursor position based on the scrollbar one.
+ void setCursorFromScrollbar();
- ///
+ /// return the pixel width of the document view
+ int workWidth() const;
+ /// return the pixel height of the document view
+ int workHeight() const;
+
+ /// switch between primary and secondary keymaps for RTL entry
void switchKeyMap();
+ /// return true for events that will handle
+ FuncStatus getStatus(FuncRequest const & cmd);
+ /// execute the given function
+ bool dispatch(FuncRequest const & argument);
+
///
- bool ChangeInsets(Inset::Code code, string const & from,
- string const & to);
- ///
- bool ChangeRefsIfUnique(string const & from, string const & to);
- ///
- bool ChangeCitationsIfUnique(string const & from, string const & to);
+ void selectionRequested();
///
- string const getClipboard() const;
+ void selectionLost();
+
///
- void stuffClipboard(string const &) const;
+ void workAreaResize(int width, int height);
+
+ /// a function should be executed from the workarea
+ bool workAreaDispatch(FuncRequest const & ev);
+
+ /// clear the X selection
+ void unsetXSel();
+
+ /// access to offset
+ int offset_ref() const;
+ /// access to anchor
+ lyx::pit_type anchor_ref() const;
+
+ /// access to full cursor
+ LCursor & cursor();
+ /// access to full cursor
+ LCursor const & cursor() const;
+ ///
+ LyXText * text() const;
+ /// sets cursor and open all relevant collapsable insets.
+ void setCursor(DocIterator const &);
+ /// sets cursor; this is used when handling LFUN_MOUSE_PRESS.
+ void mouseSetCursor(LCursor & cur);
+
+ /* Sets the selection. When \c backwards == false, set anchor
+ * to \c cur and cursor to \c cur + \c length. When \c
+ * backwards == true, set anchor to \c cur and cursor to \c
+ * cur + \c length.
+ */
+ void putSelectionAt(DocIterator const & cur,
+ int length, bool backwards);
///
- bool dispatch(FuncRequest const & argument);
- /// height of a normal line in pixels (zoom factor considered)
- int defaultHeight() const;
- ///
- void haveSelection(bool sel);
+ ViewMetricsInfo const & viewMetricsInfo();
///
- int workHeight() const;
+ void updateMetrics(bool singlepar = false);
private:
///
- struct Pimpl;
+ class Pimpl;
///
- friend struct BufferView::Pimpl;
+ friend class BufferView::Pimpl;
///
Pimpl * pimpl_;
};
-
-///
-BufferView::UpdateCodes operator|(BufferView::UpdateCodes uc1,
- BufferView::UpdateCodes uc2);
-
-#endif
+#endif // BUFFERVIEW_H