source: trunk/tools/qdoc3/tree.h@ 674

Last change on this file since 674 was 651, checked in by Dmitry A. Kuminov, 16 years ago

trunk: Merged in qt 4.6.2 sources.
File size: 6.6 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
4** All rights reserved.
5** Contact: Nokia Corporation (qt-info@nokia.com)
6**
7** This file is part of the tools applications of the Qt Toolkit.
8**
9** $QT_BEGIN_LICENSE:LGPL$
10** Commercial Usage
11** Licensees holding valid Qt Commercial licenses may use this file in
12** accordance with the Qt Commercial License Agreement provided with the
13** Software or, alternatively, in accordance with the terms contained in
14** a written agreement between you and Nokia.
15**
16** GNU Lesser General Public License Usage
17** Alternatively, this file may be used under the terms of the GNU Lesser
18** General Public License version 2.1 as published by the Free Software
19** Foundation and appearing in the file LICENSE.LGPL included in the
20** packaging of this file. Please review the following information to
21** ensure the GNU Lesser General Public License version 2.1 requirements
22** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
23**
24** In addition, as a special exception, Nokia gives you certain additional
25** rights. These rights are described in the Nokia Qt LGPL Exception
26** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
27**
28** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you have questions regarding the use of this file, please contact
37** Nokia at qt-info@nokia.com.
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42/*
43 tree.h
44*/
45
46#ifndef TREE_H
47#define TREE_H
48
49#include "node.h"
50#include <QDomElement>
51#include <QXmlStreamWriter>
52
53QT_BEGIN_NAMESPACE
54
55class QStringList;
56class TreePrivate;
57
58class Tree
59{
60 public:
61 enum FindFlag { SearchBaseClasses = 0x1,
62 SearchEnumValues = 0x2,
63 NonFunction = 0x4 };
64
65 Tree();
66 ~Tree();
67
68 Node *findNode(const QStringList &path, Node *relative=0, int findFlags=0);
69 Node *findNode(const QStringList &path,
70 Node::Type type,
71 Node *relative = 0,
72 int findFlags = 0);
73 FunctionNode *findFunctionNode(const QStringList &path,
74 Node *relative = 0,
75 int findFlags = 0);
76 FunctionNode *findFunctionNode(const QStringList &parentPath,
77 const FunctionNode *clone,
78 Node *relative = 0,
79 int findFlags = 0);
80 void addBaseClass(ClassNode *subclass,
81 Node::Access access,
82 const QStringList &basePath,
83 const QString &dataTypeWithTemplateArgs,
84 InnerNode *parent = 0);
85 void addPropertyFunction(PropertyNode *property,
86 const QString &funcName,
87 PropertyNode::FunctionRole funcRole);
88 void addToGroup(Node *node, const QString &group);
89 void addToPublicGroup(Node *node, const QString &group);
90 QMultiMap<QString, Node *> groups() const;
91 QMultiMap<QString, QString> publicGroups() const;
92 void resolveInheritance(NamespaceNode *rootNode = 0);
93 void resolveProperties();
94 void resolveGroups();
95 void resolveTargets();
96 void fixInheritance(NamespaceNode *rootNode = 0);
97 void setVersion(const QString &version) { vers = version; }
98 NamespaceNode *root() { return &roo; }
99
100 QString version() const { return vers; }
101 const Node *findNode(const QStringList &path,
102 const Node *relative = 0,
103 int findFlags = 0) const;
104 const Node *findNode(const QStringList &path,
105 Node::Type type, const
106 Node *relative = 0,
107 int findFlags = 0) const;
108 const FunctionNode *findFunctionNode(const QStringList &path,
109 const Node *relative = 0,
110 int findFlags = 0) const;
111 const FunctionNode *findFunctionNode(const QStringList &parentPath,
112 const FunctionNode *clone,
113 const Node *relative = 0,
114 int findFlags = 0) const;
115 const FakeNode *findFakeNodeByTitle(const QString &title) const;
116 const Node *findUnambiguousTarget(const QString &target, Atom *&atom) const;
117 Atom *findTarget(const QString &target, const Node *node) const;
118 const NamespaceNode *root() const { return &roo; }
119 void readIndexes(const QStringList &indexFiles);
120 bool generateIndexSection(QXmlStreamWriter &writer, const Node *node,
121 bool generateInternalNodes = false) const;
122 void generateIndexSections(QXmlStreamWriter &writer, const Node *node,
123 bool generateInternalNodes = false) const;
124 void generateIndex(const QString &fileName,
125 const QString &url,
126 const QString &title,
127 bool generateInternalNodes = false) const;
128 void generateTagFileCompounds(QXmlStreamWriter &writer,
129 const InnerNode *inner) const;
130 void generateTagFileMembers(QXmlStreamWriter &writer,
131 const InnerNode *inner) const;
132 void generateTagFile(const QString &fileName) const;
133 void addExternalLink(const QString &url, const Node *relative);
134 QString fullDocumentName(const Node *node) const;
135 QString fullDocumentLocation(const Node *node) const;
136
137 private:
138 void resolveInheritance(int pass, ClassNode *classe);
139 FunctionNode *findVirtualFunctionInBaseClasses(ClassNode *classe,
140 FunctionNode *clone);
141 void fixPropertyUsingBaseClasses(ClassNode *classe, PropertyNode *property);
142 NodeList allBaseClasses(const ClassNode *classe) const;
143 void readIndexFile(const QString &path);
144 void readIndexSection(const QDomElement &element, InnerNode *parent,
145 const QString &indexUrl);
146 QString readIndexText(const QDomElement &element);
147 void resolveIndex();
148
149 private:
150 NamespaceNode roo;
151 QString vers;
152 TreePrivate *priv;
153};
154
155QT_END_NAMESPACE
156
157#endif
Note: See TracBrowser for help on using the repository browser.