Added comments to XdxfLoadDialog
authorMateusz Półrola <mateusz.polrola@comarch.pl>
Thu, 5 Aug 2010 13:22:48 +0000 (15:22 +0200)
committerMateusz Półrola <mateusz.polrola@comarch.pl>
Thu, 5 Aug 2010 13:22:48 +0000 (15:22 +0200)
trunk/src/includes/DictDialog.h
trunk/src/plugins/xdxf/src/XdxfPlugin/XdxfDictDialog.h
trunk/src/plugins/xdxf/src/XdxfPlugin/XdxfLoadDialog.h

index 0e32ee1..7932404 100644 (file)
 
 class Settings;
 
+//! Interface for plugin dialog provider
 class DictDialog : public QObject {
     Q_OBJECT
 
 public:
     DictDialog(QObject*parent=0) : QObject(parent) {}
+
+    /*!
+      Shows add new dictionary dialog and returns settings of new dict
+      \param parent parent widget on which will be displayed dialog
+      */
     virtual Settings* addNewDictionary(QWidget*parent=0)=0;
+
+    /*!
+      Shows settings dialog and save new settings in plugin
+      \param parent parent widget on which will be displayed dialog
+      */
     virtual void changeSettings(QWidget*parent=0)=0;
 };
 
index 1dd98c2..b9292f6 100644 (file)
 #include "XdxfLoadDialog.h"
 
 
+//! Implementation of DictDialog interface for xdxf plugin
 class XdxfDictDialog : public DictDialog {
     Q_OBJECT
 public:
     explicit XdxfDictDialog(QObject *parent = 0);
 
+    /*!
+      Shows add new xdxf dictionary dialog and returns settings of new dict
+      \param parent parent widget on which will be displayed dialog
+      */
     Settings* addNewDictionary(QWidget *parent);
+
+    /*!
+      Shows settings dialog and save new settings in plugin
+      \param parent parent widget on which will be displayed dialog
+      */
     void changeSettings(QWidget *parent);
 };
 
index 88c3711..fd367e5 100644 (file)
 #include <QtGui>
 #include "../../../../includes/settings.h"
 
-
+//! Displays dialog which allow user to add new xdxf dictionary
 class XdxfLoadDialog : public QDialog {
     Q_OBJECT
 public:
     explicit XdxfLoadDialog(QWidget *parent = 0);
+
+    /*! Displays dialog and returns settings of new dictionary
+        \return Setting object containing new dictionary settings or NULL in
+        case which user cancel dialog
+    */
     static Settings* getSettings(QWidget *parent);
+
+    //! Returns choosen by user dictionary file path
     QString dicitonaryFilePath();
+
+    //! Returns if user want to cache dictionary
     bool generateCache();
 
 signals: