]> git.lyx.org Git - lyx.git/blobdiff - src/insets/lyxinset.h
reformatting and remove using delc
[lyx.git] / src / insets / lyxinset.h
index 8995208977c8d3ce0249988d3022c585d95d85e9..86321f977cf7f3fcda1cb2e12d679410534130f0 100644 (file)
@@ -1,49 +1,58 @@
 // -*- C++ -*-
 /* This file is part of
- * ======================================================
+ * ====================================================== 
  * 
  *           LyX, The Document Processor
  *      
- *         Copyright (C) 1995 Matthias Ettrich
+ *           Copyright 1995-2000 the LyX Team.
  *
- *======================================================*/
-#ifndef _LYXINSET_H
-#define _LYXINSET_H
+ * ====================================================== */
+
+#ifndef LYXINSET_H
+#define LYXINSET_H
 
 #ifdef __GNUG__
 #pragma interface
 #endif
 
-#include "definitions.h"
+#include <vector>
+
+#include <X11/Xlib.h>
+
 #include "gettext.h"
 #include "lyxfont.h"
 #include "lyxlex.h"
-#include "lyxscreen.h"
+#include "commandtags.h"
 
+class BufferView;
 class Buffer;
+class Painter;
+class LyXText;
+
 struct LaTeXFeatures;
 
+
 /// Insets
 class Inset {
 public:
-       /** This is not quite the correct place for this enum, but it is
-         better than definitions.h. I think the correct would be to let
-         each subclass of Inset declare its own enum code. Actually the
-         notion of an Inset::Code should be avoided, but I am not sure how
-         this could be done in a cleaner way. */
+       /** This is not quite the correct place for this enum. I think
+           the correct would be to let each subclass of Inset declare
+           its own enum code. Actually the notion of an Inset::Code
+           should be avoided, but I am not sure how this could be done
+           in a cleaner way. */
        enum Code {
                ///
                NO_CODE,
                ///
                TOC_CODE,  // do these insets really need a code? (ale)
                ///
-               LOF_CODE,
+               LOF_CODE, // 2
                ///
                LOT_CODE,
                ///
                LOA_CODE,
                ///
-               QUOTE_CODE,
+               QUOTE_CODE, // 5
                ///
                MARK_CODE,
                ///
@@ -53,7 +62,7 @@ public:
                ///
                HTMLURL_CODE,
                ///
-               SEPARATOR_CODE,
+               SEPARATOR_CODE, // 10
                ///
                ENDING_CODE,
                ///
@@ -63,7 +72,7 @@ public:
                ///
                ACCENT_CODE,
                ///
-               MATH_CODE,
+               MATH_CODE, // 15
                ///
                INDEX_CODE,
                ///
@@ -73,79 +82,171 @@ public:
                ///
                PARENT_CODE,
                ///
-               BIBTEX_CODE
+               BIBTEX_CODE, // 20
+               ///
+               TEXT_CODE,
+               ///
+               ERT_CODE,
+               ///
+               FOOT_CODE,
+               ///
+               MARGIN_CODE,
+               ///
+               FLOAT_CODE, // 25
+               ///
+               MINIPAGE_CODE,
+               ///
+               SPECIALCHAR_CODE,
+               ///
+               TABULAR_CODE,
+               ///
+               EXTERNAL_CODE,
+               ///
+               THEOREM_CODE, // 30
+               ///
+               CAPTION_CODE,
+               ///
+               MATHMACRO_CODE,
+               ///
+               ERROR_CODE,
+               ///
+               CITE_CODE
        };
 
        ///
-       virtual ~Inset(){};
+       enum {
+               ///
+               TEXT_TO_INSET_OFFSET = 2
+       };
+
+       ///
+       enum EDITABLE {
+               ///
+               NOT_EDITABLE = 0,
+               ///
+               IS_EDITABLE,
+               ///
+               HIGHLY_EDITABLE
+       };
+
        ///
-       virtual int Ascent(LyXFont const &font) const=0;
+       Inset() { owner_ = 0; top_x = top_baseline = 0; scx = 0; }
        ///
-       virtual int Descent(LyXFont const &font) const=0;
+       virtual ~Inset() {}
        ///
-       virtual int Width(LyXFont const& font) const=0;
+       virtual int ascent(BufferView *, LyXFont const &) const = 0;
        ///
-       virtual LyXFont ConvertFont(LyXFont font);
+       virtual int descent(BufferView *, LyXFont const &) const = 0;
        ///
-       virtual void Draw(LyXFont font, LyXScreen &scr, int baseline, float &x)=0;
+       virtual int width(BufferView *, LyXFont const &) const = 0;
        ///
-       //virtual void setBuffer(Buffer const&) {;}
+       virtual void draw(BufferView *, LyXFont const &,
+                         int baseline, float & x, bool cleared) const = 0;
+       /// update the inset representation
+       virtual void update(BufferView *, LyXFont const &, bool = false)
+               {}
+       ///
+       virtual LyXFont const ConvertFont(LyXFont const & font) const;
        /// what appears in the minibuffer when opening
-       virtual char const* EditMessage() {return _("Opened inset");}
+       virtual string const EditMessage() const;
+       ///
+       virtual void Edit(BufferView *, int x, int y, unsigned int button);
        ///
-       virtual void Edit(int, int);
+       virtual EDITABLE Editable() const;
+       /// This is called when the user clicks inside an inset
+       virtual void InsetButtonPress(BufferView *, int, int, int) {}
+       /// This is called when the user releases the button inside an inset
+       virtual void InsetButtonRelease(BufferView *, int, int, int) {}
+       /// This is caleld when the user moves the mouse inside an inset
+       virtual void InsetMotionNotify(BufferView *, int , int , int) {}
        ///
-       virtual unsigned char Editable() const;
+       virtual bool IsTextInset() const { return false; }
+       ///
+       virtual bool doClearArea() const { return true; }
        ///
        virtual bool AutoDelete() const;
        ///
-       virtual void Write(FILE *file)=0;
+       virtual void Write(Buffer const *, std::ostream &) const = 0;
        ///
-       virtual void Read(LyXLex &lex)=0;
+       virtual void Read(Buffer const *, LyXLex & lex) = 0;
        /** returns the number of rows (\n's) of generated tex code.
-        fragile != 0 means, that the inset should take care about
+        fragile == true means, that the inset should take care about
         fragile commands by adding a \protect before.
+        If the free_spc (freespacing) variable is set, then this inset
+        is in a free-spacing paragraph.
         */
-       virtual int Latex(FILE *file, signed char fragile)=0;
-       virtual int Latex(LString &file, signed char fragile)=0;
+       virtual int Latex(Buffer const *, std::ostream &, bool fragile,
+                         bool free_spc) const = 0;
+       ///
+       virtual int Ascii(Buffer const *,
+                         std::ostream &, int linelen = 0) const = 0;
        ///
-       virtual int Linuxdoc(LString &/*file*/) = 0;
+       virtual int Linuxdoc(Buffer const *, std::ostream &) const = 0;
        ///
-       virtual int DocBook(LString &/*file*/) = 0;
+       virtual int DocBook(Buffer const *, std::ostream &) const = 0;
        /// Updates needed features for this inset.
-       virtual void Validate(LaTeXFeatures &features) const;
+       virtual void Validate(LaTeXFeatures & features) const;
        ///
        virtual bool Deletable() const;
 
        /// returns LyX code associated with the inset. Used for TOC, ...)
-       virtual Inset::Code LyxCode() const = 0;
+       virtual Inset::Code LyxCode() const { return NO_CODE; }
   
-       /// Get the label that appears at screen
-       virtual LString getLabel(int) const {
-               return LString();
-       }
-
-       /// used for autocorrection
-       virtual bool IsEqual(Inset* /*other*/){
-               return false;
+       virtual std::vector<string> const getLabelList() const {
+               return std::vector<string>();
        }
 
        ///
-       virtual Inset* Clone()=0;
+       virtual Inset * Clone(Buffer const &) const = 0;
 
        /// returns true to override begin and end inset in file
        virtual bool DirectWrite() const;
 
        /// Returns true if the inset should be centered alone
-       virtual bool Display() const { return false; }  
+       virtual bool display() const { return false; }
        /// Changes the display state of the inset
-       virtual void SetDisplay(bool) {  }  
+       virtual void display(bool) {}
        ///
-       virtual int GetNumberOfLabels() const {
-               return 0;
-       }
+       /// returns true if this inset needs a row on it's own
+       ///
+       virtual bool needFullRow() const { return false; }
+       ///
+       virtual bool InsertInsetAllowed(Inset *) const { return false; }
+       ///
+       void setInsetName(string const & s) { name = s; }
+       ///
+       string const getInsetName() const { return name; }
+       ///
+       void setOwner(Inset * inset) { owner_ = inset; }
+       ///
+       Inset * owner() const { return owner_; }
+       ///
+       int x() const { return top_x; }
+       ///
+       int y() const { return top_baseline; }
+       //
+       // because we could have fake text insets and have to call this
+       // inside them without cast!!!
+       ///
+       virtual LyXText * getLyXText(BufferView const *, bool const recursive=false) const;
+       ///
+       virtual void deleteLyXText(BufferView *, bool = true) const {}
+       ///
+       virtual void resizeLyXText(BufferView *) const {}
+       /// returns the actuall scroll-value
+       int scroll() const { return scx; }
+
+protected:
+       ///
+       mutable int top_x;
+       mutable int top_baseline;
+       mutable int scx;
 
+private:
+       ///
+       Inset * owner_;
+       ///
+       string name;
 };
 
 
@@ -177,35 +278,102 @@ public:
   */
 class UpdatableInset: public Inset {
 public:
+       /** Dispatch result codes
+           Now that nested updatable insets are allowed, the local dispatch
+           becomes a bit complex, just two possible results (boolean)
+           are not enough. 
+        
+           DISPATCHED   = the inset catched the action
+           DISPATCHED_NOUPDATE = the inset catched the action and no update
+                                  is needed here to redraw the inset
+           FINISHED     = the inset must be unlocked as a result
+                          of the action
+           UNDISPATCHED = the action was not catched, it should be
+                          dispatched by lower level insets
+       */ 
+       enum RESULT {
+           UNDISPATCHED = 0,
+           DISPATCHED,
+           DISPATCHED_NOUPDATE,
+           FINISHED
+       };
+    
+       /// To convert old binary dispatch results
+       RESULT DISPATCH_RESULT(bool b) {
+               return b ? DISPATCHED : FINISHED;
+       }
+
        ///
-       virtual ~UpdatableInset() { };
+       UpdatableInset() {}
        ///
-       virtual unsigned char Editable() const;
+       virtual EDITABLE Editable() const;
    
        /// may call ToggleLockedInsetCursor
-       virtual void ToggleInsetCursor();
+       virtual void ToggleInsetCursor(BufferView *);
        ///
-       virtual void GetCursorPos(int&, int&) { }
+       virtual void ShowInsetCursor(BufferView *, bool show=true);
        ///
-       virtual void InsetButtonPress(int x, int y, int button);
+       virtual void HideInsetCursor(BufferView *);
        ///
-       virtual void InsetButtonRelease(int x, int y, int button);
-       
+       virtual void GetCursorPos(BufferView *, int &, int &) const {}
        ///
-       virtual void InsetKeyPress(XKeyEvent *ev);
+       virtual void InsetButtonPress(BufferView *, int x, int y, int button);
        ///
-       virtual void InsetMotionNotify(int x, int y, int state);
+       virtual void InsetButtonRelease(BufferView *,
+                                       int x, int y, int button);
        ///
-       virtual void InsetUnlock();
-   
+       virtual void InsetKeyPress(XKeyEvent * ev);
+       ///
+       virtual void InsetMotionNotify(BufferView *, int x, int y, int state);
+       ///
+       virtual void InsetUnlock(BufferView *);
+       ///
+       virtual void Edit(BufferView *, int x, int y, unsigned int button);
+       ///
+       virtual void draw(BufferView *, LyXFont const &,
+                         int baseline, float & x, bool cleared) const;
+       ///
+       virtual void SetFont(BufferView *, LyXFont const &,
+                            bool toggleall = false);
+       ///
+       virtual bool InsertInset(BufferView *, Inset *) { return false; }
+       ///
+       virtual bool InsertInsetAllowed(Inset *) const { return true; }
+       ///
+       virtual UpdatableInset * GetLockingInset() { return this; }
+       ///
+       virtual UpdatableInset * GetFirstLockingInsetOfType(Inset::Code c)
+               { return (c == LyxCode()) ? this : 0; }
+       ///
+       virtual unsigned int InsetInInsetY() { return 0; }
+       ///
+       virtual bool UpdateInsetInInset(BufferView *, Inset *)
+               { return false; }
+       ///
+       virtual bool LockInsetInInset(BufferView *, UpdatableInset *)
+               { return false; }
+       ///
+       virtual bool UnlockInsetInInset(BufferView *, UpdatableInset *,
+                                       bool /*lr*/ = false)
+               { return false; }
        ///  An updatable inset could handle lyx editing commands
-       virtual bool LocalDispatch(int, char const*) { return false; };
-       //
-       bool isCursorVisible() const { return cursor_visible; }
-protected:
+       virtual RESULT LocalDispatch(BufferView *, kb_action, string const &);
        ///
-       bool cursor_visible;
-};
+       virtual bool isCursorVisible() const { return cursor_visible; }
+       ///
+       virtual int getMaxWidth(BufferView * bv, UpdatableInset const *) const;
+       ///
+       int scroll() const { return scx; }
+       ///
+       virtual bool ShowInsetDialog(BufferView *) const { return false; }
 
+protected:
+       ///
+       mutable bool cursor_visible;
 
+       // scrolls to absolute position in bufferview-workwidth * sx units
+       void scroll(BufferView *, float sx) const;
+       // scrolls offset pixels
+       void scroll(BufferView *, int offset) const;
+};
 #endif