diff options
Diffstat (limited to 'src/reflist.h')
-rw-r--r-- | src/reflist.h | 94 |
1 files changed, 94 insertions, 0 deletions
diff --git a/src/reflist.h b/src/reflist.h new file mode 100644 index 0000000..e6aaeef --- /dev/null +++ b/src/reflist.h @@ -0,0 +1,94 @@ +/****************************************************************************** + * + * $Id: reflist.h,v 1.2 2001/03/19 19:27:41 root Exp $ + * + * + * Copyright (C) 1997-2011 by Dimitri van Heesch. + * + * Permission to use, copy, modify, and distribute this software and its + * documentation under the terms of the GNU General Public License is hereby + * granted. No representations are made about the suitability of this software + * for any purpose. It is provided "as is" without express or implied warranty. + * See the GNU General Public License for more details. + * + * Documents produced by Doxygen are derivative works derived from the + * input used in their production; they are not affected by this license. + * + */ + +#ifndef _REFLIST_H +#define _REFLIST_H + +#include "qtbc.h" +#include <qintdict.h> +#include <qlist.h> +#include "sortdict.h" + +/*! This struct represents an item in the list of references. */ +struct RefItem +{ + RefItem() /*: written(FALSE)*/ {} + QCString text; //!< text of the item. + QCString listAnchor; //!< anchor in the list + + QCString prefix; //!< type prefix for the name + QCString name; //!< name of the entity containing the reference + QCString title; //!< display name of the entity + QCString args; //!< optional arguments for the entity (if function) + //bool written; + QList<RefItem> extraItems; //!< more items belonging to the same entity +}; + +/*! List of items sorted by title */ +class SortedRefItems : public SDict<RefItem> +{ + public: + SortedRefItems(int size=17) : SDict<RefItem>(size) {} + virtual ~SortedRefItems() {} + int compareItems(GCI item1,GCI item2) + { + RefItem *r1 = (RefItem*)item1; + RefItem *r2 = (RefItem*)item2; + return stricmp(r1->title,r2->title); + } +}; + +/*! @brief List of cross-referenced items + * + * This class represents a list of items that are put + * at a certain point in the documentation by some special command + * and are collected in a list. The items cross-reference the + * documentation and the list. + * + * Examples are the todo list, the test list and the bug list, + * introduced by the \\todo, \\test, and \\bug commands respectively. + */ +class RefList +{ + public: + int addRefItem(); + RefItem *getRefItem(int todoItemId); + RefItem *getFirstRefItem(); + RefItem *getNextRefItem(); + QCString listName() const; + QCString pageTitle() const; + QCString sectionTitle() const; + + RefList(const char *listName, + const char *pageTitle,const char *secTitle + ); + ~RefList(); + void insertIntoList(const char *key,RefItem *item); + void generatePage(); + + private: + int m_id; + QCString m_listName; + QCString m_pageTitle; + QCString m_secTitle; + SortedRefItems *m_itemList; + QIntDict<RefItem> *m_dict; + QIntDictIterator<RefItem> *m_dictIterator; +}; + +#endif |