src/insets/insetinclude.h

   1 // -*- C++ -*-
   2 /**
   3  * \file insetinclude.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author Lars Gullik Bjønnes
   8  *
   9  * Full author contact details are available in file CREDITS.
  10  */
  11
  12 #ifndef INSET_INCLUDE_H
  13 #define INSET_INCLUDE_H
  14
  15 #include "inset.h"
  16 #include "insetcommandparams.h"
  17 #include "render_button.h"
  18 #include <boost/scoped_ptr.hpp>
  19
  20 class Buffer;
  21 class Dimension;
  22 class LaTeXFeatures;
  23 class RenderMonitoredPreview;
  24
  25
  26 /// for including tex/lyx files
  27 class InsetInclude: public InsetOld {
  28 public:
  29         ///
  30         InsetInclude(InsetCommandParams const &);
  31         ~InsetInclude();
  32
  33         /// Override these InsetButton methods if Previewing
  34         void metrics(MetricsInfo & mi, Dimension & dim) const;
  35         ///
  36         void draw(PainterInfo & pi, int x, int y) const;
  37         ///
  38         virtual bool display() const;
  39
  40         /// get the parameters
  41         InsetCommandParams const & params(void) const;
  42
  43         ///
  44         InsetBase::Code lyxCode() const { return InsetBase::INCLUDE_CODE; }
  45         /** Fills \c list
  46          *  \param buffer the Buffer containing this inset.
  47          *  \param list the list of labels in the child buffer.
  48          */
  49         void getLabelList(Buffer const & buffer,
  50                           std::vector<std::string> & list) const;
  51         /** Fills \c keys
  52          *  \param buffer the Buffer containing this inset.
  53          *  \param keys the list of bibkeys in the child buffer.
  54          */
  55         void fillWithBibKeys(Buffer const & buffer,
  56                 std::vector<std::pair<std::string,std::string> > & keys) const;
  57         /** Update the cache with all bibfiles in use of the child buffer
  58          *  (including bibfiles of grandchild documents).
  59          *  Does nothing if the child document is not loaded to prevent
  60          *  automatic loading of all child documents upon loading the master.
  61          *  \param buffer the Buffer containing this inset.
  62          */
  63         void updateBibfilesCache(Buffer const & buffer);
  64         /** Return the cache with all bibfiles in use of the child buffer
  65          *  (including bibfiles of grandchild documents).
  66          *  Return an empty vector if the child doc is not loaded.
  67          *  \param buffer the Buffer containing this inset.
  68          */
  69         std::vector<std::string> const &
  70         getBibfilesCache(Buffer const & buffer) const;
  71         ///
  72         EDITABLE editable() const { return IS_EDITABLE; }
  73         ///
  74         void write(Buffer const &, std::ostream &) const;
  75         ///
  76         void read(Buffer const &, LyXLex &);
  77         ///
  78         int latex(Buffer const &, std::ostream &,
  79                   OutputParams const &) const;
  80         ///
  81         int plaintext(Buffer const &, std::ostream &,
  82                   OutputParams const &) const;
  83         ///
  84         int linuxdoc(Buffer const &, std::ostream &,
  85                      OutputParams const &) const;
  86         ///
  87         int docbook(Buffer const &, std::ostream &,
  88                     OutputParams const &) const;
  89         ///
  90         void validate(LaTeXFeatures &) const;
  91         ///
  92         void addPreview(lyx::graphics::PreviewLoader &) const;
  93         ///
  94         bool getStatus(LCursor &, FuncRequest const &, FuncStatus &) const;
  95 protected:
  96         InsetInclude(InsetInclude const &);
  97         ///
  98         virtual void doDispatch(LCursor & cur, FuncRequest & cmd);
  99 private:
 100         virtual std::auto_ptr<InsetBase> doClone() const;
 101
 102         /** Slot receiving a signal that the external file has changed
 103          *  and the preview should be regenerated.
 104          */
 105         void fileChanged() const;
 106
 107         friend class InsetIncludeMailer;
 108
 109         /// set the parameters
 110         void set(InsetCommandParams const & params, Buffer const &);
 111         /// get the text displayed on the button
 112         std::string const getScreenLabel(Buffer const &) const;
 113         ///
 114         void write(std::ostream &) const;
 115         ///
 116         void read(LyXLex &);
 117
 118         /// the parameters
 119         InsetCommandParams params_;
 120         /// holds the entity name that defines the file location (SGML)
 121         std::string const include_label;
 122
 123         /// The pointer never changes although *preview_'s contents may.
 124         boost::scoped_ptr<RenderMonitoredPreview> const preview_;
 125
 126         /// cache
 127         mutable bool set_label_;
 128         mutable RenderButton button_;
 129 };
 130
 131
 132 #include "mailinset.h"
 133
 134 class InsetIncludeMailer : public MailInset {
 135 public:
 136         ///
 137         InsetIncludeMailer(InsetInclude & inset);
 138         ///
 139         virtual InsetBase & inset() const { return inset_; }
 140         ///
 141         virtual std::string const & name() const { return name_; }
 142         ///
 143         virtual std::string const inset2string(Buffer const &) const;
 144         ///
 145         static void string2params(std::string const &, InsetCommandParams &);
 146         ///
 147         static std::string const params2string(InsetCommandParams const &);
 148 private:
 149         ///
 150         static std::string const name_;
 151         ///
 152         InsetInclude & inset_;
 153 };
 154
 155 #endif // INSETINCLUDE_H