Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
|
A class for holding the members of a collection of doc pages. More...
#include <collectionnode.h>
Public Member Functions | |
CollectionNode (NodeType type, Aggregate *parent, const QString &name) | |
bool | isCollectionNode () const override |
Returns true if this is an instance of CollectionNode. | |
QString | qtVariable () const override |
If this node is a CollectionNode, its QT variable is returned. | |
void | setQtVariable (const QString &v) override |
If this node is a CollectionNode, its QT variable is set to v. | |
QString | cmakePackage () const override |
QString | cmakeComponent () const override |
QString | cmakeTargetItem () const override |
void | setCMakePackage (const QString &package) override |
void | setCMakeComponent (const QString &component) override |
void | setCMakeTargetItem (const QString &targetItem) override |
void | addMember (Node *node) override |
Appends node to the collection node's member list, if and only if it isn't already in the member list. | |
bool | hasNamespaces () const override |
Returns true if this collection node contains at least one namespace node. | |
bool | hasClasses () const override |
Returns true if this collection node contains at least one class node. | |
bool | wasSeen () const override |
Returns the seen flag data member of this node if it is a NamespaceNode or a CollectionNode. | |
QString | fullTitle () const override |
Returns a string that can be used as the full title for the documentation of this node. | |
QString | logicalModuleName () const override |
If this is a CollectionNode, this function returns the logical module name. | |
QString | logicalModuleVersion () const override |
Returns the logical module version. | |
QString | logicalModuleIdentifier () const override |
If this is a CollectionNode, this function returns the logical module identifier. | |
QString | state () const |
Sets or gets a description of this module's state. | |
template<typename F > | |
NodeMap | getMembers (F &&predicate) const |
NodeMap | getMembers (Node::NodeType type) const |
Returns a map containing this collection node's member nodes with a specified node type. | |
void | setLogicalModuleInfo (const QStringList &info) override |
This function accepts the logical module info as a string list. | |
void | setState (const QString &state) |
void | markMerged () |
bool | isMerged () |
const NodeList & | members () const |
void | markSeen () |
void | markNotSeen () |
Public Member Functions inherited from PageNode | |
PageNode (Aggregate *parent, const QString &name) | |
This constructor sets the PageNode's parent and the name is the argument of the {\page} command. | |
PageNode (NodeType type, Aggregate *parent, const QString &name) | |
This constructor is not called directly. | |
bool | isPageNode () const override |
Always returns true because this is a PageNode. | |
bool | isTextPageNode () const override |
Returns true if this instance of PageNode is not an Aggregate. | |
QString | title () const override |
Returns the node's title, which is used for the page title. | |
QString | subtitle () const override |
Returns the node's subtitle, which may be empty. | |
QString | fullTitle () const override |
Returns the node's full title. | |
bool | setTitle (const QString &title) override |
Sets the node's title, which is used for the page title. | |
bool | setSubtitle (const QString &subtitle) override |
Sets the node's subtitle. | |
virtual QString | imageFileName () const |
If this PageNode is an ExampleNode, the image file name data member is returned. | |
virtual void | setImageFileName (const QString &) |
If this PageNode is an ExampleNode, the image file name data member is set to ifn. | |
bool | noAutoList () const |
Returns the value of the no auto-list flag. | |
void | setNoAutoList (bool b) |
Sets the no auto-list flag to b. | |
const QStringList & | groupNames () const |
Returns a const reference to the string list containing all the group names. | |
void | appendGroupName (const QString &t) override |
Appends t to the list of group names. | |
const PageNode * | navigationParent () const |
void | setNavigationParent (const PageNode *parent) |
void | markAttribution () |
bool | isAttribution () const |
Public Member Functions inherited from Node< _Tp > | |
std::pair< edge_iterator, bool > | insertEdge (iterator other) const |
edge_iterator | begin () const |
edge_iterator | end () const |
bool | operator== (const Node< _Tp > &other) const |
bool | operator!= (const Node< _Tp > &other) const |
bool | operator< (const Node< _Tp > &other) const |
virtual | ~Node ()=default |
The default destructor is virtual so any subclass of Node can be deleted by deleting a pointer to Node. | |
virtual Node * | clone (Aggregate *) |
When reimplemented in a subclass, this function creates a clone of this node on the heap and makes the clone a child of parent. | |
virtual Tree * | tree () const |
Returns a pointer to the Tree this node is in. | |
Aggregate * | root () const |
NodeType | nodeType () const |
Returns this node's type. | |
QString | nodeTypeString () const |
Returns this node's type as a string for use as an attribute value in XML or HTML. | |
Genus | genus () const |
Returns this node's Genus. | |
void | setGenus (Genus t) |
bool | isActive () const |
Returns true if this node's status is Active . | |
bool | isClass () const |
Returns true if the node type is Class . | |
bool | isCppNode () const |
Returns true if this node's Genus value is CPP . | |
bool | isDontDocument () const |
Returns true if this node's status is DontDocument . | |
bool | isEnumType () const |
Returns true if the node type is Enum . | |
bool | isExample () const |
Returns true if the node type is Example . | |
bool | isExternalPage () const |
Returns true if the node type is ExternalPage . | |
bool | isFunction (Genus g=DontCare) const |
Returns true if this is a FunctionNode and its Genus is set to g. | |
bool | isGroup () const |
Returns true if the node type is Group . | |
bool | isHeader () const |
Returns true if the node type is HeaderFile . | |
bool | isIndexNode () const |
Returns true if this node was created from something in an index file. | |
bool | isModule () const |
Returns true if the node type is Module . | |
bool | isNamespace () const |
Returns true if the node type is Namespace . | |
bool | isPage () const |
Returns true if the node type is Page . | |
bool | isPreliminary () const |
Returns true if this node's status is Preliminary . | |
bool | isPrivate () const |
Returns true if this node's access is Private . | |
bool | isProperty () const |
Returns true if the node type is Property . | |
bool | isProxyNode () const |
Returns true if the node type is Proxy . | |
bool | isPublic () const |
Returns true if this node's access is Public . | |
bool | isProtected () const |
Returns true if this node's access is Protected . | |
bool | isQmlBasicType () const |
Returns true if the node type is QmlBasicType . | |
bool | isQmlModule () const |
Returns true if the node type is QmlModule . | |
bool | isQmlNode () const |
Returns true if this node's Genus value is QML . | |
bool | isQmlProperty () const |
Returns true if the node type is QmlProperty . | |
bool | isQmlType () const |
Returns true if the node type is QmlType or QmlValueType . | |
bool | isRelatedNonmember () const |
Returns true if this is a related nonmember of something. | |
bool | isStruct () const |
Returns true if the node type is Struct . | |
bool | isSharedCommentNode () const |
Returns true if the node type is SharedComment . | |
bool | isTypeAlias () const |
Returns true if the node type is Typedef . | |
bool | isTypedef () const |
Returns true if the node type is Typedef . | |
bool | isUnion () const |
Returns true if the node type is Union . | |
bool | isVariable () const |
Returns true if the node type is Variable . | |
bool | isGenericCollection () const |
Returns true if the node type is Collection . | |
virtual bool | isDeprecated () const |
Returns true if this node's status is Deprecated . | |
virtual bool | isAbstract () const |
Returns true if the ClassNode or QmlTypeNode is marked abstract. | |
virtual bool | isAggregate () const |
Returns true if this node is an aggregate, which means it inherits Aggregate and can therefore have children. | |
virtual bool | isFirstClassAggregate () const |
Returns true if this Node is an Aggregate but not a ProxyNode. | |
virtual bool | isAlias () const |
Returns true if this QML property is marked as an alias. | |
virtual bool | isAttached () const |
Returns true if the QML property or QML method node is marked as attached. | |
virtual bool | isClassNode () const |
Returns true if this is an instance of ClassNode. | |
virtual bool | isDefault () const |
Returns true if the QML property node is marked as default. | |
virtual bool | isInternal () const |
Returns true if the node's status is Internal , or if its parent is a class with Internal status. | |
virtual bool | isMacro () const |
returns true if either FunctionNode::isMacroWithParams() or FunctionNode::isMacroWithoutParams() returns true. | |
virtual bool | isRelatableType () const |
Returns true if this node is something you can relate things to with the relates command. | |
virtual bool | isMarkedReimp () const |
Returns true if the FunctionNode is marked as a reimplemented function. | |
virtual bool | isPropertyGroup () const |
Returns true if the node is a SharedCommentNode for documenting multiple C++ properties or multiple QML properties. | |
virtual bool | isStatic () const |
Returns true if the FunctionNode represents a static function. | |
virtual bool | isWrapper () const |
Returns true if the node is a class node or a QML type node that is marked as being a wrapper class or wrapper QML type, or if it is a member of a wrapper class or type. | |
QString | plainName () const |
Returns this node's name member. | |
QString | plainFullName (const Node *relative=nullptr) const |
Constructs and returns the node's fully qualified name by recursively ascending the parent links and prepending each parent name + "::". | |
QString | plainSignature () const |
Constructs and returns the node's fully qualified signature by recursively ascending the parent links and prepending each parent name + "::" to the plain signature. | |
QString | fullName (const Node *relative=nullptr) const |
Constructs and returns this node's full name. | |
virtual QString | signature (Node::SignatureOptions) const |
void Node::setGenus(Genus t) Sets this node's Genus to t. | |
const QString & | fileNameBase () const |
Returns the node's file name base string, which is built once, when Generator::fileBase() is called and stored in the Node. | |
bool | hasFileNameBase () const |
Returns true if the node's file name base has been set. | |
void | setFileNameBase (const QString &t) |
Sets the node's file name base to t. | |
void | setAccess (Access t) |
Sets the node's access type to t. | |
void | setLocation (const Location &t) |
Sets the node's declaration location, its definition location, or both, depending on the suffix of the file name from the file path in location t. | |
void | setDoc (const Doc &doc, bool replace=false) |
Sets this Node's Doc to doc. | |
void | setStatus (Status t) |
Sets the node's status to t. | |
void | setThreadSafeness (ThreadSafeness t) |
Sets the node's thread safeness to t. | |
void | setSince (const QString &since) |
Sets the information about the project and version a node was introduced in, unless the version is lower than the 'ignoresince. | |
void | setPhysicalModuleName (const QString &name) |
Sets the node's physical module name. | |
void | setUrl (const QString &url) |
Sets the node's URL to url, which is the url to the page that the node represents. | |
void | setTemplateDecl (std::optional< RelaxedTemplateDeclaration > t) |
void | setReconstitutedBrief (const QString &t) |
When reading an index file, this function is called with the reconstituted brief clause t to set the node's brief clause. | |
void | setParent (Aggregate *n) |
Sets the node's parent pointer to n. | |
void | setIndexNodeFlag (bool isIndexNode=true) |
Sets a flag in this Node that indicates the node was created for something in an index file. | |
void | setHadDoc () |
void | setComparisonCategory (const ComparisonCategory &category) |
ComparisonCategory | comparisonCategory () const |
virtual void | setRelatedNonmember (bool b) |
Sets a flag in the node indicating whether this node is a related nonmember of something. | |
virtual void | setAbstract (bool) |
If this node is a ClassNode or a QmlTypeNode, the node's abstract flag data member is set to b. | |
virtual void | setWrapper () |
If this node is a ClassNode or a QmlTypeNode, the node's wrapper flag data member is set to true . | |
virtual void | setDataType (const QString &) |
If this node is a PropertyNode or a QmlPropertyNode, its data type data member is set to dataType. | |
virtual QString | element () const |
If this node is a QmlPropertyNode or a FunctionNode, this function returns the name of the parent node. | |
virtual bool | docMustBeGenerated () const |
This function is called to perform a test to decide if the node must have documentation generated. | |
void | markInternal () |
Sets the node's access to Private and its status to Internal. | |
virtual void | markDefault () |
If this node is a QmlPropertyNode, it is marked as the default property. | |
virtual void | markReadOnly (bool) |
If this node is a QmlPropertyNode, then the property's read-only flag is set to flag. | |
Aggregate * | parent () const |
Returns the node's parent pointer. | |
const QString & | name () const |
Returns the node's name data member. | |
QString | physicalModuleName () const |
QString | url () const |
Returns the node's URL, which is the url of the documentation page created for the node or the url of an external page if the node is an ExternalPageNode. | |
virtual bool | hasTag (const QString &) const |
If this node is a FunctionNode, the function returns true if the function has the tag t. | |
void | setDeprecated (const QString &sinceVersion) |
Sets the Node status to Node::Deprecated, unless sinceVersion represents a future version. | |
const QString & | deprecatedSince () const |
const QMap< LinkType, std::pair< QString, QString > > & | links () const |
Returns a reference to this node's link map. | |
void | setLink (LinkType linkType, const QString &link, const QString &desc) |
This function creates a pair that describes a link. | |
Access | access () const |
Returns the node's Access setting, which can be Public , Protected , or Private . | |
const Location & | declLocation () const |
Returns the Location where this node's declaration was seen. | |
const Location & | defLocation () const |
Returns the Location where this node's dedefinition was seen. | |
const Location & | location () const |
If this node's definition location is empty, this function returns this node's declaration location. | |
const Doc & | doc () const |
Returns a reference to the node's Doc data member. | |
bool | isInAPI () const |
bool | hasDoc () const |
Returns true if this node is documented, or it represents a documented node read from the index ('had doc'), or this node is sharing a non-empty doc with other nodes. | |
bool | hadDoc () const |
Status | status () const |
Returns the node's status value. | |
ThreadSafeness | threadSafeness () const |
Returns the thread safeness value for whatever this node represents. | |
ThreadSafeness | inheritedThreadSafeness () const |
If this node has a parent, the parent's thread safeness value is returned. | |
QString | since () const |
Returns the node's since string, which can be empty. | |
const std::optional< RelaxedTemplateDeclaration > & | templateDecl () const |
const QString & | reconstitutedBrief () const |
bool | isSharingComment () const |
This function returns true if the node is sharing a comment with other nodes. | |
void | setSharedCommentNode (SharedCommentNode *t) |
SharedCommentNode * | sharedCommentNode () |
QString | extractClassName (const QString &string) const |
Extract a class name from the type string and return it. | |
virtual QString | qmlTypeName () const |
If this is a QmlPropertyNode or a FunctionNode representing a QML method, this function returns the qmlTypeName() of the parent() node. | |
virtual QString | qmlFullBaseName () const |
If this is a QmlTypeNode, this function returns the QML full base name. | |
virtual CollectionNode * | logicalModule () const |
If this is a QmlTypeNode, a pointer to its QML module is returned, which is a pointer to a CollectionNode. | |
virtual void | setQmlModule (CollectionNode *) |
If this is a QmlTypeNode, this function sets the QML type's QML module pointer to the CollectionNode t. | |
virtual ClassNode * | classNode () |
If this is a QmlTypeNode, this function returns the pointer to the C++ ClassNode that this QML type represents. | |
virtual void | setClassNode (ClassNode *) |
If this is a QmlTypeNode, this function sets the C++ class node to cn. | |
QString | fullDocumentName () const |
Construct the full document name for this node and return it. | |
QString | qualifyCppName () |
Returns the CPP node's qualified name by prepending the namespaces name + "::" if there isw a namespace. | |
QString | qualifyQmlName () |
Returns the QML node's qualified name by prepending the logical module name. | |
QString | qualifyWithParentName () |
Return the name of this node qualified with the parent name and "::" if there is a parent name. | |
Additional Inherited Members | |
Public Types inherited from Node< _Tp > | |
enum | NodeType : unsigned char { NoType , Namespace , Class , Struct , Union , HeaderFile , Page , Enum , Example , ExternalPage , Function , Typedef , TypeAlias , Property , Variable , Group , Module , QmlType , QmlModule , QmlProperty , QmlValueType , SharedComment , Collection , Proxy } |
An unsigned char value that identifies an object as a particular subclass of Node. More... | |
enum | Genus : unsigned char { DontCare = 0x0 , CPP = 0x1 , QML = 0x4 , DOC = 0x8 , API = CPP | QML } |
An unsigned char value that specifies whether the Node represents a C++ element, a QML element, or a text document. More... | |
enum | Status : unsigned char { Deprecated , Preliminary , Active , Internal , DontDocument } |
An unsigned char that specifies the status of the documentation element in the documentation set. More... | |
enum | ThreadSafeness : unsigned char { UnspecifiedSafeness , NonReentrant , Reentrant , ThreadSafe } |
An unsigned char that specifies the degree of thread-safeness of the element. More... | |
enum | SignatureOption : unsigned char { SignaturePlain = 0x0 , SignatureDefaultValues = 0x1 , SignatureReturnType = 0x2 , SignatureTemplateParams = 0x4 } |
enum | LinkType : unsigned char { StartLink , NextLink , PreviousLink , ContentsLink } |
An unsigned char value that probably should be moved out of the Node base class. More... | |
enum | FlagValue { FlagValueDefault = -1 , FlagValueFalse = 0 , FlagValueTrue = 1 } |
A value used in PropertyNode and QmlPropertyNode that can be -1, 0, or +1. More... | |
typedef std::set< Node< _Tp > > | Repository |
typedef Repository::iterator | iterator |
typedef std::list< iterator >::iterator | edge_iterator |
Static Public Member Functions inherited from Node< _Tp > | |
static iterator | get (_Tp data) |
static iterator | begin_nodes () |
static iterator | end_nodes () |
static Repository & | repository () |
static Genus | getGenus (NodeType t) |
Determines the appropriate Genus value for the NodeType value t and returns that Genus value. | |
static FlagValue | toFlagValue (bool b) |
Converts the boolean value b to an enum representation of the boolean type, which includes an enum value for the {default value} of the item, i.e. | |
static bool | fromFlagValue (FlagValue fv, bool defaultValue) |
Converts the enum fv back to a boolean value. | |
static QString | nodeTypeString (NodeType t) |
Returns the node type t as a string for use as an attribute value in XML or HTML. | |
static bool | nodeNameLessThan (const Node *first, const Node *second) |
Returns true if the node n1 is less than node n2. | |
static bool | nodeSortKeyOrNameLessThan (const Node *n1, const Node *n2) |
Returns true if node n1 is less than node n2 when comparing the sort keys, defined with. | |
Public Attributes inherited from Node< _Tp > | |
bool | root |
Returns a pointer to the root of the Tree this node is in. | |
int | dfn |
_Tp | data |
std::list< iterator > | outs |
Protected Member Functions inherited from Node< _Tp > | |
Node () | |
Node (_Tp d) | |
Node (NodeType type, Aggregate *parent, QString name) | |
Construct a node with the given type and having the given parent and name. | |
Protected Attributes inherited from PageNode | |
bool | m_noAutoList { false } |
QString | m_title {} |
QString | m_subtitle {} |
QStringList | m_groupNames {} |
bool | is_attribution { false } |
A class for holding the members of a collection of doc pages.
Definition at line 14 of file collectionnode.h.
Definition at line 17 of file collectionnode.h.
Appends node to the collection node's member list, if and only if it isn't already in the member list.
Reimplemented from Node< _Tp >.
Definition at line 19 of file collectionnode.cpp.
|
inlinenodiscardoverridevirtual |
Reimplemented from Node< _Tp >.
Definition at line 26 of file collectionnode.h.
|
inlinenodiscardoverridevirtual |
Reimplemented from Node< _Tp >.
Definition at line 25 of file collectionnode.h.
|
inlinenodiscardoverridevirtual |
Reimplemented from Node< _Tp >.
Definition at line 27 of file collectionnode.h.
|
inlinenodiscardoverridevirtual |
Returns a string that can be used as the full title for the documentation of this node.
In this base class, the name() is returned. In a PageNode, title() is returned. In a HeaderNode, if the title() is empty, the name() is returned. If the title() is not empty then name-title is returned. In a CollectionNode, the title() is returned.
Reimplemented from Node< _Tp >.
Definition at line 36 of file collectionnode.h.
Definition at line 46 of file collectionnode.h.
|
inline |
Returns a map containing this collection node's member nodes with a specified node type.
Definition at line 56 of file collectionnode.h.
References Node< _Tp >::nodeType().
Referenced by WebXMLGenerator::append(), DocBookGenerator::generateAtom(), DocBookGenerator::generateCollectionNode(), and HtmlGenerator::generateCollectionNode().
|
nodiscardoverridevirtual |
Returns true
if this collection node contains at least one class node.
Reimplemented from Node< _Tp >.
Definition at line 40 of file collectionnode.cpp.
References Node< _Tp >::isClassNode(), and Node< _Tp >::isInAPI().
Referenced by WebXMLGenerator::append().
|
nodiscardoverridevirtual |
Returns true
if this collection node contains at least one namespace node.
Reimplemented from Node< _Tp >.
Definition at line 29 of file collectionnode.cpp.
References Node< _Tp >::isClassNode(), and Node< _Tp >::isInAPI().
Referenced by WebXMLGenerator::append().
|
inlinenodiscardoverridevirtual |
Returns true if this is an instance of CollectionNode.
Reimplemented from Node< _Tp >.
Definition at line 22 of file collectionnode.h.
|
inline |
Definition at line 74 of file collectionnode.h.
Referenced by QDocDatabase::mergeCollections().
|
inlinenodiscardoverridevirtual |
If this is a CollectionNode, this function returns the logical module identifier.
Otherwise it returns an empty string.
Reimplemented from Node< _Tp >.
Definition at line 39 of file collectionnode.h.
|
inlinenodiscardoverridevirtual |
If this is a CollectionNode, this function returns the logical module name.
Otherwise it returns an empty string.
Reimplemented from Node< _Tp >.
Definition at line 37 of file collectionnode.h.
|
nodiscardoverridevirtual |
Returns the logical module version.
Reimplemented from Node< _Tp >.
Definition at line 65 of file collectionnode.cpp.
|
inline |
Definition at line 73 of file collectionnode.h.
Referenced by QDocDatabase::mergeCollections().
|
inline |
Definition at line 79 of file collectionnode.h.
|
inline |
Definition at line 78 of file collectionnode.h.
Referenced by CppCodeParser::processTopicCommand().
|
inlinenodiscard |
Definition at line 76 of file collectionnode.h.
Referenced by WebXMLGenerator::addAtomElements(), WebXMLGenerator::append(), and DocBookGenerator::generateAtom().
|
inlinenodiscardoverridevirtual |
If this node is a CollectionNode, its QT variable is returned.
Otherwise an empty string is returned. I don't know what the QT variable is used for.
Reimplemented from Node< _Tp >.
Definition at line 23 of file collectionnode.h.
Reimplemented from Node< _Tp >.
Definition at line 29 of file collectionnode.h.
Reimplemented from Node< _Tp >.
Definition at line 28 of file collectionnode.h.
Reimplemented from Node< _Tp >.
Definition at line 30 of file collectionnode.h.
|
overridevirtual |
This function accepts the logical module info as a string list.
If the logical module info contains the version number, it splits the version number on the '.' character to get the major and minor version numbers. Both major and minor version numbers should be provided, but the minor version number is not strictly necessary.
Reimplemented from Node< _Tp >.
Definition at line 81 of file collectionnode.cpp.
If this node is a CollectionNode, its QT variable is set to v.
Otherwise the function does nothing. I don't know what the QT variable is used for.
Reimplemented from Node< _Tp >.
Definition at line 24 of file collectionnode.h.
Definition at line 64 of file collectionnode.h.
|
inlinenodiscard |
Sets or gets a description of this module's state.
For example, {"Technical Preview"}. This string is used when generating the module's documentation page and reference pages of the module's members.
Definition at line 43 of file collectionnode.h.
|
inlinenodiscardoverridevirtual |
Returns the seen
flag data member of this node if it is a NamespaceNode or a CollectionNode.
Otherwise it returns false
. If true
is returned, it means that the location where the namespace or collection is to be documented has been found.
Reimplemented from Node< _Tp >.
Definition at line 34 of file collectionnode.h.
Referenced by DocBookGenerator::generateDocumentation(), and Generator::generateDocumentation().