+// Copyright (C) 2014-20xx CEA/DEN, EDF R&D
+
/*
* Config_WidgetAPI.h
*
#ifndef CONFIG_WIDGETAPI_H_
#define CONFIG_WIDGETAPI_H_
-#include <Config.h>
+#include <Config_def.h>
#include <cstdarg>
#include <string>
struct _xmlDoc;
//<<
-
+/*!
+ * \class Config_WidgetAPI
+ * \ingroup Config
+ * \brief Provides low-level API for WidgetFactory for reading xml definitions of widgets
+ */
class CONFIG_EXPORT Config_WidgetAPI
{
-public:
- Config_WidgetAPI(std::string theRawXml);
+ public:
virtual ~Config_WidgetAPI();
- void reset();
- bool nextWidget();
-
- std::string widgetType();
+ //! Returns name of widget's node (attribute)
+ std::string widgetType() const;
+ //! Returns true if widget has container type, which means it able to contain other widgets
+ bool isGroupBoxWidget() const;
+ //! Returns true if widget has page type;
+ //! Page is container widget with combo box control to switch between pages
+ bool isPagedWidget() const;
- std::string widgetIcon();
- std::string widgetLabel();
- std::string widgetTooltip();
+ //! Returns id of current widget
+ std::string widgetId() const;
+ //! Returns icon of current widget
+ std::string widgetIcon() const;
+ //! Returns text for label of current widget
+ std::string widgetLabel() const;
+ //! Returns text for tooltip of current widget
+ std::string widgetTooltip() const;
+ //! Returns a custom property of current widget
+ std::string getProperty(const char* thePropName) const;
- std::string getProperty(const char* thePropName);
+ /*! Checks if the XML representation of widget has given attribute,
+ * if yes - returns it's bool value, if no, or if the value can not
+ * be converted to bool - returns theDefault.
+ * \param theAttributeName attribute to check
+ * \param theDefault default value on bad data
+ * \return the boolean result
+ */
+ bool getBooleanAttribute(const char* theAttributeName, bool theDefault) const;
-protected:
- bool isNode(xmlNodePtr theNode, const char* name, ...);
+ protected:
+ /// These fields are accessible for ModuleBase_WidgetFactory only
+ Config_WidgetAPI(std::string theRawXml);
+ //! Pass to the next (sibling) node of widget's xml definition. If impossible, returns false
+ bool toNextWidget();
+ //! Pass into the child node of widget's xml definition. If impossible, returns false
+ bool toChildWidget();
+ //! Pass into the parent node of widget's xml definition. If impossible, returns false
+ bool toParentWidget();
-private:
- xmlDocPtr myDoc;
- xmlNodePtr myCurrentNode;
+ private:
+ xmlDocPtr myDoc; //!< Pointer to the root of widget's xml definition
+ xmlNodePtr myCurrentNode; //!< Pointer to the current node in the widget's xml definition
+ friend class ModuleBase_WidgetFactory;
};
#endif /* CONFIG_WIDGETAPI_H_ */