// -*- C++ -*-
-/* This file is part of
- * ======================================================
+/**
+ * \file WorkArea.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
*
- * LyX, The Document Processor
+ * \author unknown
+ * \author John Levon
+ * \author Abdelrazak Younes
*
- * Copyright 1995 Matthias Ettrich
- * Copyright 1995-2001 The LyX Team.
- *
- * ======================================================*/
+ * Full author contact details are available in file CREDITS.
+ */
+
+#ifndef BASE_WORKAREA_H
+#define BASE_WORKAREA_H
+
+#include "frontends/key_state.h"
+#include "frontends/KeySymbol.h"
+#include "frontends/Timeout.h"
+
+#include "support/docstring.h"
-#ifndef WORKAREA_H
-#define WORKAREA_H
+#include <boost/signals/trackable.hpp>
-#ifdef __GNUG__
-#pragma interface
-#endif
-#include <utility>
+namespace lyx {
-#include <sigc++/signal_system.h>
+class BufferView;
+class FuncRequest;
+class LyXView;
-#include FORMS_H_LOCATION
-#include "frontends/Painter.h"
+namespace frontend {
-///
-class WorkArea {
+class Painter;
+
+/// types of cursor in work area
+enum CursorShape {
+ /// normal I-beam
+ BAR_SHAPE,
+ /// L-shape for locked insets of a different language
+ L_SHAPE,
+ /// reverse L-shape for RTL text
+ REVERSED_L_SHAPE
+};
+
+/**
+ * The work area class represents the widget that provides the
+ * view onto a document. It is owned by the BufferView, and
+ * is responsible for handing events back to its owning BufferView.
+ * It works in concert with the BaseScreen class to update the
+ * widget view of a document.
+ */
+class WorkArea : public boost::signals::trackable {
public:
+ WorkArea(int id, LyXView & lyx_view);
+
+ virtual ~WorkArea() {}
+
+ int const id() const { return id_; }
+
+ void setBufferView(BufferView * buffer_view);
+
///
- WorkArea(int xpos, int ypos, int width, int height);
- ///
- ~WorkArea();
- ///
- Painter & getPainter() { return painter_; }
- ///
- int workWidth() const { return work_area->w; }
- ///
- unsigned int width() const { return work_area->w + scrollbar->w; }
- //unsigned int width() const { return backgroundbox->w + 15; }
- ///
- unsigned int height() const { return work_area->h; }
- //unsigned int height() const { return backgroundbox->h; }
- ///
- int xpos() const { return work_area->x; }
- //int xpos() const { return backgroundbox->x; }
- ///
- int ypos() const { return work_area->y; }
- //int ypos() const { return backgroundbox->y; }
- ///
- void resize(int xpos, int ypos, int width, int height);
- ///
- void redraw() const {
- fl_redraw_object(work_area);
- fl_redraw_object(scrollbar);
- }
- ///
- void setFocus() const;
- ///
- Window getWin() const { return work_area->form->window; }
- ///
- bool hasFocus() const { return work_area->focus; }
- ///
- bool active() const { return work_area->active; }
- ///
- bool belowMouse() const;
- ///
- bool visible() const { return work_area->form->visible; }
- ///
- void greyOut() const;
- ///
- void setScrollbar(double pos, double length_fraction) const;
- ///
- void setScrollbarValue(double y) const {
- fl_set_scrollbar_value(scrollbar, y);
- }
- ///
- void setScrollbarBounds(double, double) const;
- ///
- void setScrollbarIncrements(double inc) const;
- ///
- double getScrollbarValue() const {
- return fl_get_scrollbar_value(scrollbar);
- }
- ///
- std::pair<float, float> const getScrollbarBounds() const {
- std::pair<float, float> p;
- fl_get_scrollbar_bounds(scrollbar, &p.first, &p.second);
- return p;
- }
- ///
- Pixmap getPixmap() const { return workareapixmap; }
- /// xforms callback
- static int work_area_handler(FL_OBJECT *, int event,
- FL_Coord, FL_Coord,
- int /*key*/, void * xev);
- /// xforms callback
- static void scroll_cb(FL_OBJECT *, long);
- /// a selection exists
- void haveSelection(bool) const;
- ///
- string const getClipboard() const;
- ///
- void putClipboard(string const &) const;
- // Signals
- ///
- SigC::Signal0<void> workAreaExpose;
- ///
- SigC::Signal1<void, double> scrollCB;
- ///
- SigC::Signal2<void, KeySym, unsigned int> workAreaKeyPress;
- ///
- SigC::Signal3<void, int, int, unsigned int> workAreaButtonPress;
- ///
- SigC::Signal3<void, int, int, unsigned int> workAreaButtonRelease;
- ///
- SigC::Signal3<void, int, int, unsigned int> workAreaMotionNotify;
- ///
- SigC::Signal0<void> workAreaFocus;
- ///
- SigC::Signal0<void> workAreaUnfocus;
- ///
- SigC::Signal0<void> workAreaEnter;
- ///
- SigC::Signal0<void> workAreaLeave;
+ BufferView & bufferView();
///
- SigC::Signal3<void, int, int, unsigned int> workAreaDoubleClick;
+ BufferView const & bufferView() const;
+
+ /// \return true if has the keyboard input focus.
+ virtual bool hasFocus() const = 0;
+
+ /// return the width of the work area in pixels
+ virtual int width() const = 0;
+
+ /// return the height of the work area in pixels
+ virtual int height() const = 0;
+
+ /**
+ * Update the scrollbar.
+ * @param height the total document height in pixels
+ * @param pos the current position in the document, in pixels
+ * @param line_height the line-scroll amount, in pixels
+ */
+ virtual void setScrollbarParams(int height, int pos, int line_height) = 0;
+
///
- SigC::Signal3<void, int, int, unsigned int> workAreaTripleClick;
- /// emitted when an X client has requested our selection
- SigC::Signal0<void> selectionRequested;
- /// emitted when another X client has stolen our selection
- SigC::Signal0<void> selectionLost;
-
- /// handles SelectionRequest X Event, to fill the clipboard
- int event_cb(XEvent * xev);
-private:
+ virtual void scheduleRedraw() = 0;
+
+ /// redraw the screen, without using existing pixmap
+ virtual void redraw();
///
- void createPixmap(int, int);
+ void stopBlinkingCursor();
+ void startBlinkingCursor();
+
+ /// Process Key pressed event.
+ /// This needs to be public because it is accessed externally by GuiView.
+ void processKeySym(KeySymbolPtr key, key_modifier::state state);
+protected:
+ /// cause the display of the given area of the work area
+ virtual void expose(int x, int y, int w, int h) = 0;
+ ///
+ void dispatch(FuncRequest const & cmd0,
+ key_modifier::state = key_modifier::none);
+ ///
+ void resizeBufferView();
+ ///
+ void scrollBufferView(int position);
+ /// hide the visible cursor, if it is visible
+ void hideCursor();
+ /// show the cursor if it is not visible
+ void showCursor();
+ /// toggle the cursor's visibility
+ void toggleCursor();
+ /// hide the cursor
+ virtual void removeCursor() = 0;
+ /// paint the cursor and store the background
+ virtual void showCursor(int x, int y, int h, CursorShape shape) = 0;
+ ///
+ void updateScrollbar();
///
- FL_OBJECT * backgroundbox;
+ BufferView * buffer_view_;
+
///
- FL_OBJECT * work_area;
+ LyXView & lyx_view_;
///
- FL_OBJECT * scrollbar;
+ bool greyed_out_;
+
+private:
///
- mutable FL_OBJECT * splash_;
+ int id_;
///
- mutable FL_OBJECT * splash_text_;
- /// The pixmap overlay on the workarea
- Pixmap workareapixmap;
+ void displayMessage(docstring const &);
+ /// buffer messages signal connection
+ boost::signals::connection message_connection_;
+
+ /// is the cursor currently displayed
+ bool cursor_visible_;
+
///
- Painter painter_;
- /// if we call redraw with true needed for locking-insets
- bool screen_cleared;
+ Timeout cursor_timeout_;
};
-#endif
+
+} // namespace frontend
+} // namespace lyx
+
+#endif // BASE_WORKAREA_H