]> git.lyx.org Git - lyx.git/blobdiff - src/insets/inset.h
quick fix for commented out figures
[lyx.git] / src / insets / inset.h
index 33b8f7ad7f52b745b3c882f4d80ca07b49b06fe2..9b0a4c5149107e14475793919eb618d2eed7a2b8 100644 (file)
@@ -1,9 +1,9 @@
 // -*- C++ -*-
 /* This file is part of
- * ====================================================== 
- * 
+ * ======================================================
+ *
  *           LyX, The Document Processor
- *      
+ *
  *           Copyright 1995-2001 the LyX Team.
  *
  * ====================================================== */
@@ -19,6 +19,7 @@
 #include "LString.h"
 #include <X11/Xlib.h>
 #include "commandtags.h"
+#include "LColor.h"
 
 class LyXFont;
 class BufferView;
@@ -95,8 +96,10 @@ public:
                TABULAR_CODE,
                ///
                EXTERNAL_CODE,
+#if 0
                ///
                THEOREM_CODE,
+#endif
                ///
                CAPTION_CODE,
                ///
@@ -106,7 +109,9 @@ public:
                ///
                CITE_CODE,
                ///
-               FLOAT_LIST_CODE
+               FLOAT_LIST_CODE,
+               ///
+               INDEX_PRINT_CODE
        };
 
        ///
@@ -124,10 +129,12 @@ public:
                ///
                HIGHLY_EDITABLE
        };
-       
+
+       ///
+       Inset();
+       ///
+       Inset(Inset const & in, bool same_id = false);
        ///
-       Inset() : top_x(0), top_baseline(0), scx(0), id_(inset_id++), owner_(0) {}
-       /// Virtual base destructor
        virtual ~Inset() {}
        ///
        virtual int ascent(BufferView *, LyXFont const &) const = 0;
@@ -141,18 +148,22 @@ public:
        /// 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 string const editMessage() const;
        ///
        virtual void edit(BufferView *, int x, int y, unsigned int button);
        ///
+       virtual void edit(BufferView *, bool front = true);
+       ///
        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) {}
+       // the bool return is used to see if we opened a dialog so that we can
+       // check this from an outer inset and open the dialog of the
+       // outer inset if that one has one!
+       virtual bool insetButtonRelease(BufferView *, int, int, int)
+               { return editable() == IS_EDITABLE; }
        /// This is called when the user moves the mouse inside an inset
        virtual void insetMotionNotify(BufferView *, int , int , int) {}
        ///
@@ -161,6 +172,10 @@ public:
        virtual bool doClearArea() const { return true; }
        ///
        virtual bool autoDelete() const;
+       /// returns true the inset can hold an inset of given type
+       virtual bool insetAllowed(Inset::Code) const { return false; }
+       /// wrapper around the above
+       bool insetAllowed(Inset * in) const;
        ///
        virtual void write(Buffer const *, std::ostream &) const = 0;
        ///
@@ -179,22 +194,22 @@ public:
        ///
        virtual int linuxdoc(Buffer const *, std::ostream &) const = 0;
        ///
-       virtual int docBook(Buffer const *, std::ostream &) const = 0;
+       virtual int docbook(Buffer const *, std::ostream &) const = 0;
        /// Updates needed features for this inset.
        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 { return NO_CODE; }
-       
+
        virtual std::vector<string> const getLabelList() const {
                return std::vector<string>();
        }
 
        ///
        virtual Inset * clone(Buffer const &, bool same_ids = false) const = 0;
-       
+
        /// returns true to override begin and end inset in file
        virtual bool directWrite() const;
 
@@ -207,16 +222,22 @@ public:
        ///
        virtual bool needFullRow() const { return false; }
        ///
-       virtual bool insertInsetAllowed(Inset *) const { return false; }
+       void setInsetName(string const & s) { name_ = s; }
        ///
-       void setInsetName(string const & s) { name = s; }
-       ///
-       string const getInsetName() const { return name; }
+       string const & getInsetName() const { return name_; }
        ///
        void setOwner(Inset * inset) { owner_ = inset; }
        ///
        Inset * owner() const { return owner_; }
        ///
+       void parOwner(Paragraph * par) { par_owner_ = par; }
+       ///
+       Paragraph * parOwner() const {return par_owner_; }
+       ///
+       void setBackgroundColor(LColor::color);
+       ///
+       LColor::color backgroundColor() const;
+       ///
        int x() const { return top_x; }
        ///
        int y() const { return top_baseline; }
@@ -251,17 +272,64 @@ public:
        virtual Paragraph * firstParagraph() const {
                return 0;
        }
+
+       ///
+       virtual Paragraph * getFirstParagraph(int /*num*/) const {
+               return 0;
+       }
+
        /// return the cursor if we own one otherwise giv'em just the
        /// BufferView cursor to work with.
        virtual LyXCursor const & cursor(BufferView * bview) const;
        /// id functions
        int id() const;
+       ///
        void id(int id_arg);
 
+       /// used to toggle insets
+       // is the inset open?
+       virtual bool isOpen() const { return false; }
+       /// open the inset
+       virtual void open(BufferView *) {}
+       /// close the inset
+       virtual void close(BufferView *) const {}
+       /// check if the font of the char we want inserting is correct
+       /// and modify it if it is not.
+       virtual bool checkInsertChar(LyXFont &);
+       /// we need this here because collapsed insets are only EDITABLE
+       virtual void setFont(BufferView *, LyXFont const &,
+                        bool toggleall = false, bool selectall = false);
+       ///
+       // needed for spellchecking text
+       ///
+       virtual bool allowSpellcheck() { return false; }
+
+       // should this inset be handled like a normal charater
+       virtual bool isChar() const { return false; }
+       // is this equivalent to a letter?
+       virtual bool isLetter() const { return false; }
+       // is this equivalent to a space (which is BTW different from
+       // a line separator)?
+       virtual bool isSpace() const { return false; }
+       // should we break lines after this inset?
+       virtual bool isLineSeparator() const { return false; }
+       // if this inset has paragraphs should they be output all as default
+       // paragraphs with "Standard" layout?
+       virtual bool forceDefaultParagraphs(Inset const *) const;
+       //
+       virtual void getDrawFont(LyXFont &) const {}
+       /* needed for widths which are % of something
+          returns the value of \textwidth in this inset. Most of the
+          time this is the width of the workarea, but if there is a
+          minipage somewhere, it will be the width of this minipage */
+       virtual int latexTextWidth(BufferView *) const;
+
 protected:
        ///
        mutable int top_x;
        ///
+       mutable bool topx_set; /* have we already drawn ourself! */
+       ///
        mutable int top_baseline;
        ///
        mutable int scx;
@@ -273,34 +341,51 @@ protected:
 private:
        ///
        Inset * owner_;
+       /// the paragraph in which this inset has been inserted
+       Paragraph * par_owner_;
        ///
-       string name;
+       string name_;
+       ///
+       LColor::color background_color_;
 };
 
 
+inline
+bool Inset::insetAllowed(Inset * in) const
+{
+       return insetAllowed(in->lyxCode());
+}
+
+
+inline
+bool Inset::checkInsertChar(LyXFont &)
+{
+       return false;
+}
+
 //  Updatable Insets. These insets can be locked and receive
 //  directly user interaction. Currently used only for mathed.
 //  Note that all pure methods from Inset class are pure here too.
-//  [Alejandro 080596] 
+//  [Alejandro 080596]
 
 /** Extracted from Matthias notes:
- * 
- * An inset can simple call LockInset in it's edit call and *ONLY* 
+ *
+ * An inset can simple call LockInset in it's edit call and *ONLY*
  * in it's edit call.
  *
- * Unlocking is either done by LyX or the inset itself with a 
+ * Unlocking is either done by LyX or the inset itself with a
  * UnlockInset-call
  *
  * During the lock, all button and keyboard events will be modified
  * and send to the inset through the following inset-features. Note that
  * Inset::insetUnlock will be called from inside UnlockInset. It is meant
  * to contain the code for restoring the menus and things like this.
- * 
+ *
  * If a inset wishes any redraw and/or update it just has to call
- * UpdateInset(this).
- * 
+ * updateInset(this).
+ *
  * It's is completly irrelevant, where the inset is. UpdateInset will
- * find it in any paragraph in any buffer. 
+ * find it in any paragraph in any buffer.
  * Of course the_locking_inset and the insets in the current paragraph/buffer
  *  are checked first, so no performance problem should occur.
  */
@@ -309,46 +394,66 @@ 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
+           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
-       */ 
+                                 is needed here to redraw the inset
+           FINISHED            = the inset must be unlocked as a result
+                                 of the action
+           FINISHED_RIGHT      = FINISHED, but put the cursor to the RIGHT of
+                                 the inset.
+           FINISHED_UP         = FINISHED, but put the cursor UP of
+                                 the inset.
+           FINISHED_DOWN       = FINISHED, but put the cursor DOWN of
+                                 the inset.
+           UNDISPATCHED        = the action was not catched, it should be
+                                 dispatched by lower level insets
+       */
        enum RESULT {
                UNDISPATCHED = 0,
                DISPATCHED,
                DISPATCHED_NOUPDATE,
-               FINISHED
+               FINISHED,
+               FINISHED_RIGHT,
+               FINISHED_UP,
+               FINISHED_DOWN
        };
-    
+
        /// To convert old binary dispatch results
        RESULT DISPATCH_RESULT(bool b) {
                return b ? DISPATCHED : FINISHED;
        }
 
        ///
-       UpdatableInset() : cursor_visible_(false), block_drawing_(false) {}
+       UpdatableInset();
+       ///
+       UpdatableInset(UpdatableInset const & in, bool same_id = false);
 
+       /// check if the font of the char we want inserting is correct
+       /// and modify it if it is not.
+       virtual bool checkInsertChar(LyXFont &);
        ///
        virtual EDITABLE editable() const;
-       
-       /// may call ToggleLockedInsetCursor
+
+       ///
        virtual void toggleInsetCursor(BufferView *);
        ///
        virtual void showInsetCursor(BufferView *, bool show = true);
        ///
        virtual void hideInsetCursor(BufferView *);
        ///
+       virtual void fitInsetCursor(BufferView *) const;
+       ///
        virtual void getCursorPos(BufferView *, int &, int &) const {}
        ///
        virtual void insetButtonPress(BufferView *, int x, int y, int button);
        ///
-       virtual void insetButtonRelease(BufferView *,
+       // the bool return is used to see if we opened a dialog so that we can
+       // check this from an outer inset and open the dialog of the outer inset
+       // if that one has one!
+       ///
+       virtual bool insetButtonRelease(BufferView *,
                                        int x, int y, int button);
        ///
        virtual void insetKeyPress(XKeyEvent * ev);
@@ -359,17 +464,13 @@ public:
        ///
        virtual void edit(BufferView *, int x, int y, unsigned int button);
        ///
+       virtual void edit(BufferView *, bool front = true);
+       ///
        virtual void draw(BufferView *, LyXFont const &,
                          int baseline, float & x, bool cleared) const;
        ///
-       virtual void setFont(BufferView *, LyXFont const &,
-                         bool toggleall = false, bool selectall = false);
-       ///
        virtual bool insertInset(BufferView *, Inset *) { return false; }
        ///
-       virtual bool insertInsetAllowed(Inset *) const { return false; }
-       virtual bool insertInsetAllowed(Inset::Code) const { return false; }
-       ///
        virtual UpdatableInset * getLockingInset() const {
                return const_cast<UpdatableInset *>(this);
        }
@@ -402,7 +503,7 @@ public:
        ///
        virtual bool showInsetDialog(BufferView *) const { return false; }
        ///
-       virtual void nodraw(bool b) {
+       virtual void nodraw(bool b) const {
                block_drawing_ = b;
        }
        ///
@@ -410,18 +511,25 @@ public:
                return block_drawing_;
        }
        ///
-       virtual bool isCollapsable() const { return false; }
+       // needed for spellchecking text
        ///
-       virtual bool collapsed() const { return false; }
-       virtual void collapsed(BufferView *, bool) {}
+       virtual bool allowSpellcheck() { return false; }
        ///
-       // needed for spellchecking text
+       virtual string const selectNextWordToSpellcheck(BufferView *, float & value) const;
        ///
-       virtual string selectNextWord(BufferView *, float & value) const;
        virtual void selectSelectedWord(BufferView *) { return; }
+       ///
        virtual void toggleSelection(BufferView *, bool /*kill_selection*/) {
                return;
        }
+       ///
+       // needed for search/replace functionality
+       ///
+       virtual bool searchForward(BufferView *, string const &,
+                                  bool = true, bool = false);
+       ///
+       virtual bool searchBackward(BufferView *, string const &,
+                                   bool = true, bool = false);
 
 protected:
        ///
@@ -441,6 +549,31 @@ private:
        ///
        mutable bool cursor_visible_;
        ///
-       bool block_drawing_;
+       mutable bool block_drawing_;
 };
+
+inline
+bool UpdatableInset::checkInsertChar(LyXFont &)
+{
+       return true;
+}
+
+/**
+ * returns true if pointer argument is valid
+ * and points to an editable inset
+ */
+inline bool isEditableInset(Inset * i)
+{
+       return i && i->editable();
+}
+
+/**
+ * returns true if pointer argument is valid
+ * and points to a highly editable inset
+ */
+inline bool isHighlyEditableInset(Inset * i)
+{
+       return i && i->editable() == Inset::HIGHLY_EDITABLE;
+}
+
 #endif