// -*- C++ -*-
-/* This file is part of
- * ======================================================
- *
- * LyX, The Document Processor
- *
- * Copyright 1995-2001 the LyX Team.
+/**
+ * \file inset.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
*
- * ====================================================== */
+ * \author Alejandro Aguilar Sierra
+ * \author Jürgen Vigna
+ * \author Lars Gullik Bjønnes
+ * \author Matthias Ettrich
+ *
+ * Full author contact details are available in file CREDITS
+ */
-#ifndef INSET_H
-#define INSET_H
+#ifndef INSETOLD_H
+#define INSETOLD_H
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include "LColor.h"
+#include "insetbase.h"
+#include "dimension.h"
+#include "support/types.h"
#include <vector>
-#include "LString.h"
-#include <X11/Xlib.h>
-#include "commandtags.h"
-#include "LColor.h"
class LyXFont;
-class BufferView;
class Buffer;
class Painter;
+class LatexRunParams;
class LyXText;
class LyXLex;
class Paragraph;
class LyXCursor;
+class FuncRequest;
+class WordLangTuple;
+class ParagraphList;
+class UpdatableInset;
-struct LaTeXFeatures;
-
+namespace lyx {
+namespace graphics {
+ class PreviewLoader;
+}
+}
/// Insets
-class Inset {
+class InsetOld : public InsetBase {
public:
/** 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
+ its own enum code. Actually the notion of an InsetOld::Code
should be avoided, but I am not sure how this could be done
in a cleaner way. */
enum Code {
///
- NO_CODE,
+ NO_CODE, // 0
///
TOC_CODE, // do these insets really need a code? (ale)
///
///
MARK_CODE,
///
- REF_CODE, // 5
+ REF_CODE,
///
- URL_CODE,
+ URL_CODE, // 5
///
HTMLURL_CODE,
///
///
ENDING_CODE,
///
- LABEL_CODE, // 10
+ LABEL_CODE,
///
- IGNORE_CODE,
+ NOTE_CODE, // 10
///
ACCENT_CODE,
///
///
INDEX_CODE,
///
- INCLUDE_CODE, // 15
+ INCLUDE_CODE,
///
- GRAPHICS_CODE,
+ GRAPHICS_CODE, // 15
///
- PARENT_CODE,
+ BIBITEM_CODE,
///
BIBTEX_CODE,
///
TEXT_CODE,
///
- ERT_CODE, // 20
+ ERT_CODE,
///
- FOOT_CODE,
+ FOOT_CODE, // 20
///
MARGIN_CODE,
///
FLOAT_CODE,
///
+ WRAP_CODE,
+ ///
MINIPAGE_CODE,
///
- SPECIALCHAR_CODE, // 25
+ SPACE_CODE, // 25
+ ///
+ SPECIALCHAR_CODE,
///
TABULAR_CODE,
///
///
FLOAT_LIST_CODE,
///
- INDEX_PRINT_CODE
+ INDEX_PRINT_CODE,
+ ///
+ OPTARG_CODE, // 35
+ ///
+ ENVIRONMENT_CODE,
+ ///
+ HFILL_CODE,
+ ///
+ NEWLINE_CODE,
+ ///
+ BRANCH_CODE
};
///
///
HIGHLY_EDITABLE
};
-
- ///
- Inset();
+
///
- Inset(Inset const & in, bool same_id = false);
+ typedef dispatch_result RESULT;
+
///
- virtual ~Inset() {}
+ InsetOld();
///
- virtual int ascent(BufferView *, LyXFont const &) const = 0;
+ InsetOld(InsetOld const & in);
///
- virtual int descent(BufferView *, LyXFont const &) const = 0;
+ int ascent() const;
///
- virtual int width(BufferView *, LyXFont const &) const = 0;
+ int descent() 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)
- {}
-#if 0
- ///
- virtual LyXFont const convertFont(LyXFont const & font) const;
-#endif
+ int width() 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) {}
- /// This is called when the user moves the mouse inside an inset
- virtual void insetMotionNotify(BufferView *, int , int , int) {}
///
virtual bool isTextInset() const { return false; }
- ///
- virtual bool doClearArea() const { return true; }
- ///
+ /// return true if the inset should be removed automatically
virtual bool autoDelete() const;
/// returns true the inset can hold an inset of given type
- virtual bool insetAllowed(Inset::Code) const { return false; }
+ virtual bool insetAllowed(InsetOld::Code) const { return false; }
/// wrapper around the above
- bool insetAllowed(Inset * in) const;
+ bool insetAllowed(InsetOld * in) const;
///
virtual void write(Buffer const *, std::ostream &) const = 0;
///
virtual void read(Buffer const *, LyXLex & lex) = 0;
- /** returns the number of rows (\n's) of generated tex code.
- 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(Buffer const *, std::ostream &, bool fragile,
- bool free_spc) const = 0;
+ /// returns the number of rows (\n's) of generated tex code.
+ virtual int latex(Buffer const *, std::ostream &,
+ LatexRunParams const &) const = 0;
///
virtual int ascii(Buffer const *,
std::ostream &, int linelen = 0) const = 0;
///
virtual int linuxdoc(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;
-
+ virtual int docbook(Buffer const *, std::ostream &, bool) const = 0;
+
/// 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 InsetOld::Code lyxCode() const { return NO_CODE; }
- ///
- 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;
///
string const & getInsetName() const { return name_; }
///
- void setOwner(Inset * inset) { owner_ = inset; }
+ void setOwner(UpdatableInset * inset) { owner_ = inset; }
///
- Inset * owner() const { return owner_; }
+ UpdatableInset * owner() const { return owner_; }
+ ///
+ void parOwner(Paragraph * par) { par_owner_ = par; }
+ ///
+ Paragraph * parOwner() const { return par_owner_; }
///
void setBackgroundColor(LColor::color);
///
// inside them without cast!!!
///
virtual LyXText * getLyXText(BufferView const *,
- bool const recursive = false) const;
+ bool recursive = false) const;
///
virtual void deleteLyXText(BufferView *, bool = true) const {}
- ///
- virtual void resizeLyXText(BufferView *, bool /*force*/= false) const {}
/// returns the actuall scroll-value
virtual int scroll(bool recursive=true) const {
if (!recursive || !owner_)
return scx;
return 0;
}
- /// try to get a paragraph pointer from it's id if we have a
- /// paragraph to give back!
- virtual Paragraph * getParFromID(int /* id */) const {
- return 0;
- }
+
/// try to get a inset pointer from it's id if we have
/// an inset to give back!
- virtual Inset * getInsetFromID(int /* id */) const {
- return 0;
- }
+ virtual InsetOld * getInsetFromID(int /*id*/) const { return 0; }
/// if this insets owns paragraphs (f.ex. InsetText) then it
/// should return it's very first one!
- virtual Paragraph * firstParagraph() const {
- return 0;
+ virtual ParagraphList * getParagraphs(int /*num*/) const { return 0; }
+ ///
+ virtual bool haveParagraphs() const {
+ return false;
}
+
/// return the cursor if we own one otherwise giv'em just the
/// BufferView cursor to work with.
virtual LyXCursor const & cursor(BufferView * bview) const;
/// open the inset
virtual void open(BufferView *) {}
/// close the inset
- virtual void close(BufferView *) {}
+ 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);
+ bool toggleall = false, bool selectall = false);
+ ///
+ // needed for spellchecking text
+ ///
+ virtual bool allowSpellcheck() const { 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(InsetOld const *) const;
+ /** returns true if, when outputing LaTeX, font changes should
+ be closed before generating this inset. This is needed for
+ insets that may contain several paragraphs */
+ virtual bool noFontChange() const { return false; }
+ //
+ 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;
+
+ /// mark the inset contents as erased (for change tracking)
+ virtual void markErased() {}
+
+ /** Adds a LaTeX snippet to the Preview Loader for transformation
+ * into a bitmap image. Does not start the laoding process.
+ *
+ * Most insets have no interest in this capability, so the method
+ * defaults to empty.
+ */
+ virtual void addPreview(lyx::graphics::PreviewLoader &) const {}
+
+ /** Find the PreviewLoader, add a LaTeX snippet to it and
+ * start the loading process.
+ *
+ * Most insets have no interest in this capability, so the method
+ * defaults to empty.
+ */
+ virtual void generatePreview() const {}
+
protected:
///
mutable int top_x;
mutable int top_baseline;
///
mutable int scx;
- ///
+ /// Used to identify the inset for cursor positioning when undoing
unsigned int id_;
///
static unsigned int inset_id;
+ ///
+ mutable Dimension dim_;
private:
///
- Inset * owner_;
+ UpdatableInset * owner_;
+ /// the paragraph in which this inset has been inserted
+ Paragraph * par_owner_;
///
string name_;
///
};
-inline
-bool Inset::insetAllowed(Inset * in) const
-{
- return insetAllowed(in->lyxCode());
-}
-
-
-inline
-bool Inset::checkInsertChar(LyXFont &)
-{
- return true;
-}
-
-// 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]
-
-/** Extracted from Matthias notes:
- *
- * 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
- * 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).
- *
- * It's is completly irrelevant, where the inset is. UpdateInset will
- * 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.
+/**
+ * returns true if pointer argument is valid
+ * and points to an editable inset
*/
-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;
- }
+bool isEditableInset(InsetOld const * i);
- ///
- UpdatableInset();
- ///
- UpdatableInset(UpdatableInset const & in, bool same_id = false);
- ///
- 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 *,
- int x, int y, int button);
- ///
- 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 edit(BufferView *, bool front = true);
- ///
- virtual void draw(BufferView *, LyXFont const &,
- int baseline, float & x, bool cleared) const;
- ///
- virtual bool insertInset(BufferView *, Inset *) { return false; }
- ///
- virtual UpdatableInset * getLockingInset() const {
- return const_cast<UpdatableInset *>(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 RESULT localDispatch(BufferView *, kb_action, string const &);
- ///
- bool isCursorVisible() const { return cursor_visible_; }
- ///
- virtual int getMaxWidth(BufferView * bv, UpdatableInset const *) const;
- ///
- int scroll(bool recursive = true) const {
- // We need this method to not clobber the real method in Inset
- return Inset::scroll(recursive);
- }
- ///
- virtual bool showInsetDialog(BufferView *) const { return false; }
- ///
- virtual void nodraw(bool b) const {
- block_drawing_ = b;
- }
- ///
- virtual bool nodraw() const {
- return block_drawing_;
- }
- ///
- // needed for spellchecking text
- ///
- virtual string const 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 const & = true, bool const & = false);
- ///
- virtual bool searchBackward(BufferView *, string const &,
- bool const & = true, bool const & = false);
-
-protected:
- ///
- void toggleCursorVisible() const {
- cursor_visible_ = !cursor_visible_;
- }
- ///
- void setCursorVisible(bool b) const {
- cursor_visible_ = b;
- }
- /// scrolls to absolute position in bufferview-workwidth * sx units
- void scroll(BufferView *, float sx) const;
- /// scrolls offset pixels
- void scroll(BufferView *, int offset) const;
+/**
+ * returns true if pointer argument is valid
+ * and points to a highly editable inset
+ */
+bool isHighlyEditableInset(InsetOld const * i);
-private:
- ///
- mutable bool cursor_visible_;
- ///
- mutable bool block_drawing_;
-};
#endif