- virtual ~modelCDMIProjectTreeNode(){}
-
- const std::string& GetPath() const
- {
- return this->path;
- }
- const std::string& GetName() const
- {
- return this->name;
- }
- const unsigned char& GetType() const
- {
- return this->type;
- }
- const int& GetLevel() const
- {
- return this->level;
- }
- const std::vector<modelCDMIProjectTreeNode>& GetChildren() const
- {
- return this->children;
- }
- void SetChildren(std::vector<modelCDMIProjectTreeNode>& children)
- {
- this->children.clear();
- this->children = children;
- }
-protected:
+ /**
+ * Destructor that doesn't do anything.
+ */
+ virtual ~modelCDMIProjectTreeNode() {};
+
+ /**
+ * Compares the precedence of an modelCDMIProjectTreeNode object with another by the node's name and its type (first folder then file).
+ * @return Either if the node x goes before (true) or after (false) y.
+ */
+ static bool CompareNodeItem(const modelCDMIProjectTreeNode* x, const modelCDMIProjectTreeNode* y);
+
+ /**
+ * Returns the id of the node in the tree of the project.
+ * @return Id of the node in the tree project.
+ */
+ const wxCDMTreeItemId& GetId() const;
+ /**
+ * Returns the full path to the node, including the name of the node.
+ * @return Node's full path.
+ */
+ const std::string& GetPath() const;
+ /**
+ * Return the name of the node, either the file name or the folder name.
+ * @return Name of the node.
+ */
+ const std::string& GetName() const;
+ /**
+ * Returns the type of node.
+ * @return Either wxDIR_FILES for files or wxDIR_DIRS for folders.
+ */
+ const unsigned char& GetType() const;
+ /**
+ * Returns the level of the node in the project tree.
+ * @return Level of the node in the project tree.
+ */
+ const int& GetLevel() const;
+ /**
+ * Returns a reference to the parent node of the actual node.
+ * @return The reference of the parent node or NULL.
+ */
+ modelCDMIProjectTreeNode* GetParent() const;
+ /**
+ * Returns an array with the hierarchy route between the node and the project root
+ * @return Hierarchy array ordered from higher to lower node level down to the project root.
+ */
+ std::vector<modelCDMIProjectTreeNode*> GetParents() const;
+ /**
+ * Returns the children nodes of the actual node.
+ * @return An array with the children nodes.
+ */
+ const std::vector<modelCDMIProjectTreeNode*>& GetChildren() const;
+ /**
+ * Returns the file size of the node.
+ * @return File size.
+ */
+ const int& GetLength();
+ /**
+ * Sets the id of the node in the project tree.
+ * @param id Id of the node.
+ */
+ void SetId(const wxCDMTreeItemId& id);
+ /**
+ * Sorts the children using the compareNodeItem function.
+ */
+ void SortChildren();
+ /**
+ * Sets the children array of the node. Warning: it discards the older children.
+ * @param children Array of children nodes.
+ */
+ void SetChildren(const std::vector<modelCDMIProjectTreeNode*>& children);
+
+ /**
+ * Refreshes the structure of the node and its children.
+ * @param result Result of the procedure.
+ * @return True if the procedure was successful.
+ */
+ virtual const bool Refresh(std::string*& result);
+ /**
+ * Opens the file explorer in the containing folder of the file or in the folder itself.
+ * @param result Result of the procedure.
+ * @return True if the procedure was successful.
+ */
+ const bool OpenInFileExplorer(std::string*& result) const;
+
+ protected:
+ /**
+ * Id of the node in the project tree.
+ */
+ wxCDMTreeItemId id;
+ /**
+ * path of the node in the computer.
+ */