]> git.lyx.org Git - lyx.git/blobdiff - src/TocBackend.h
Natbib authoryear uses (Ref1; Ref2) by default.
[lyx.git] / src / TocBackend.h
index 9563255c9040db8ea1db3434724551fcd0ea972d..bc7a414745e71d2154c42f16fba4d4c271f46959 100644 (file)
-// -*- C++ -*-\r
-/**\r
- * \file TocBackend.h\r
- * This file is part of LyX, the document processor.\r
- * Licence details can be found in the file COPYING.\r
- *\r
- * \author Jean-Marc Lasgouttes\r
- * \author Angus Leeming\r
- * \author Abdelrazak Younes\r
- *\r
- * Full author contact details are available in file CREDITS.\r
- *\r
- * TocBackend mainly used in toc.[Ch]\r
- */\r
-\r
-#ifndef TOC_BACKEND_H\r
-#define TOC_BACKEND_H\r
-\r
-#include <map>\r
-#include <iosfwd>\r
-#include <vector>\r
-#include <string>\r
-\r
-#include "pariterator.h"\r
-\r
-class Buffer;\r
-class LyXView;\r
-class Paragraph;\r
-class FuncRequest;\r
-class LCursor;\r
-\r
-namespace lyx {\r
-\r
-///\r
-/**\r
-*/\r
-class TocBackend\r
-{\r
-public:\r
-\r
-       ///\r
-       /**\r
-       */\r
-       class Item\r
-       {\r
-               friend class TocBackend;\r
-               friend bool operator==(Item const & a, Item const & b);\r
-\r
-       public:\r
-               ///\r
-               Item(\r
-                       ParConstIterator const & par_it = ParConstIterator(),\r
-                       int d = -1,\r
-                       std::string const & s = std::string());\r
-               ///\r
-               ~Item() {}\r
-               ///\r
-               bool const isValid() const;\r
-               ///\r
-               int const id() const;\r
-               ///\r
-               int const depth() const;\r
-               ///\r
-               std::string const & str() const;\r
-               ///\r
-               std::string const asString() const;\r
-               /// set cursor in LyXView to this Item\r
-               void goTo(LyXView & lv_) const;\r
-               /// the action corresponding to the goTo above\r
-               FuncRequest action() const;\r
-               \r
-       protected:\r
-               /// Current position of item.\r
-               ParConstIterator par_it_;\r
-\r
-               /// nesting depth\r
-               int depth_;\r
-\r
-               /// Full item string\r
-               std::string str_;\r
-       };\r
-\r
-       ///\r
-       typedef std::vector<Item> Toc;\r
-       typedef std::vector<Item>::const_iterator TocIterator;\r
-       ///\r
-       typedef std::map<std::string, Toc> TocList;\r
-\r
-public:\r
-       ///\r
-       TocBackend(Buffer const * buffer = NULL): buffer_(buffer) {}\r
-       ///\r
-       ~TocBackend() {}\r
-       ///\r
-       void setBuffer(Buffer const * buffer)\r
-       { buffer_ = buffer; }\r
-       ///\r
-       bool addType(std::string const & type);\r
-       ///\r
-       void update();\r
-       ///\r
-       TocList const & tocs()\r
-       { return tocs_; }\r
-       ///\r
-       std::vector<std::string> const & types()\r
-       { return types_; }\r
-       ///\r
-       Toc const & toc(std::string const & type);\r
-       /// Return the first Toc Item before the cursor\r
-       TocIterator const item(std::string const & type, ParConstIterator const &);\r
-\r
-       void asciiTocList(std::string const & type, std::ostream & os) const;\r
-\r
-private:\r
-       /// \r
-       TocList tocs_;\r
-       ///\r
-       std::vector<std::string> types_;\r
-       ///\r
-       Buffer const * buffer_;\r
-\r
-}; // TocBackend\r
-\r
-inline\r
-bool operator==(TocBackend::Item const & a, TocBackend::Item const & b)\r
-{\r
-       return a.id() == b.id() && a.str() == b.str();\r
-       // No need to compare depth.\r
-}\r
-\r
-\r
-inline\r
-bool operator!=(TocBackend::Item const & a, TocBackend::Item const & b)\r
-{\r
-       return !(a == b);\r
-}\r
-\r
-\r
-} // namespace lyx\r
-\r
-#endif // TOC_BACKEND_H\r
+// -*- C++ -*-
+/**
+ * \file TocBackend.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
+ *
+ * \author Jean-Marc Lasgouttes
+ * \author Angus Leeming
+ * \author Abdelrazak Younes
+ *
+ * Full author contact details are available in file CREDITS.
+ */
+
+#ifndef TOC_BACKEND_H
+#define TOC_BACKEND_H
+
+#include "DocIterator.h"
+
+#include "support/strfwd.h"
+
+#include <map>
+#include <vector>
+#include <string>
+
+
+namespace lyx {
+
+class Buffer;
+class FuncRequest;
+
+///
+/**
+*/
+class TocItem
+{
+       friend class Toc;
+       friend class TocBackend;
+
+public:
+       /// Default constructor for STL containers.
+       TocItem() : dit_(0) {}
+       ///
+       TocItem(DocIterator const & dit,
+               int depth,
+               docstring const & s,
+         bool output_active,
+               docstring const & t = docstring()
+               );
+       ///
+       ~TocItem() {}
+       ///
+       int id() const;
+       ///
+       int depth() const;
+       ///
+       docstring const & str() const;
+       ///
+       docstring const & tooltip() const;
+       ///
+       docstring const asString() const;
+       ///
+       DocIterator const & dit() const;
+       ///
+       bool isOutput() const { return output_; }
+
+       /// the action corresponding to the goTo above
+       FuncRequest action() const;
+
+protected:
+       /// Current position of item.
+       DocIterator dit_;
+       /// nesting depth
+       int depth_;
+       /// Full item string
+       docstring str_;
+       /// The tooltip string
+       docstring tooltip_;
+       /// Is this item in a note, inactive branch, etc?
+       bool output_;
+};
+
+
+///
+class Toc : public std::vector<TocItem>
+{
+public:
+       typedef std::vector<TocItem>::const_iterator const_iterator;
+       typedef std::vector<TocItem>::iterator iterator;
+       const_iterator item(DocIterator const & dit) const;
+       /// Look for a TocItem given its depth and string.
+       /// \return The first matching item.
+       /// \retval end() if no item was found.
+       iterator item(int depth, docstring const & str);
+};
+
+typedef Toc::const_iterator TocIterator;
+
+/// The ToC list.
+/// A class and no typedef because we want to forward declare it.
+class TocList : public std::map<std::string, Toc> {};
+
+
+///
+/**
+*/
+class TocBackend
+{
+public:
+       ///
+       TocBackend(Buffer const * buffer) : buffer_(buffer) {}
+       ///
+       void setBuffer(Buffer const * buffer) { buffer_ = buffer; }
+       ///
+       void update(bool output_active);
+       /// \return true if the item was updated.
+       bool updateItem(DocIterator const & pit);
+
+       ///
+       TocList const & tocs() const { return tocs_; }
+       TocList & tocs() { return tocs_; }
+
+       ///
+       Toc const & toc(std::string const & type) const;
+       Toc & toc(std::string const & type);
+
+       /// Return the first Toc Item before the cursor
+       TocIterator item(
+               std::string const & type, ///< Type of Toc.
+               DocIterator const & dit ///< The cursor location in the document.
+       ) const;
+
+       ///
+       void writePlaintextTocList(std::string const & type,
+               odocstringstream & os, size_t max_length) const;
+
+private:
+       ///
+       TocList tocs_;
+       ///
+       Buffer const * buffer_;
+}; // TocBackend
+
+inline bool operator==(TocItem const & a, TocItem const & b)
+{
+       return a.id() == b.id() && a.str() == b.str() && a.depth() == b.depth();
+}
+
+
+inline bool operator!=(TocItem const & a, TocItem const & b)
+{
+       return !(a == b);
+}
+
+
+} // namespace lyx
+
+#endif // TOC_BACKEND_H