Changeset 50704 in vbox for trunk/src/VBox/Frontends/VirtualBox

Timestamp:

Mar 5, 2014 1:14:20 PM (11 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

92663

Message:

FE/Qt: Medium Manager rework/cleanup: Few more comments.

Location:

trunk/src/VBox/Frontends/VirtualBox/src/medium

Files:

• UIMediumManager.cpp (modified) (1 diff)
• UIMediumManager.h (modified) (3 diffs)

trunk/src/VBox/Frontends/VirtualBox/src/medium/UIMediumManager.cpp

@@ -267 +267 @@
 void UIMediumManager::showModeless(QWidget *pCenterWidget /* = 0 */, bool fRefresh /* = true */)
 {
-    /* Prepare instance if not prepared: */
+    /* Create instance if not yet created: */
     if (!m_spInstance)
         m_spInstance = new UIMediumManager(pCenterWidget, fRefresh);

trunk/src/VBox/Frontends/VirtualBox/src/medium/UIMediumManager.h

@@ -45 +45 @@
 };
 
-/* Medium Manager Dialog: */
+/** Medium Manager dialog. */
 class UIMediumManager : public QIWithRetranslateUI2<QIMainDialog>, public Ui::UIMediumManager
 {
@@ -56 +56 @@
     enum Action { Action_Add, Action_Edit, Action_Copy, Action_Modify, Action_Remove, Action_Release };
 
-    /* Constructor/destructor: */
+    /** Constructor for Medium Manager dialog. */
     UIMediumManager(QWidget *pCenterWidget, bool fRefresh = true);
+    /** Destructor for Medium Manager dialog. */
     ~UIMediumManager();
 
 public:
 
-    /* Static API: Singleton stuff: */
+    /** Returns Medium Manager singleton instance. */
     static UIMediumManager* instance();
+    /** Shows Medium Manager singleton instance, creates new if necessary. */
     static void showModeless(QWidget *pCenterWidget, bool fRefresh = true);
 
@@ -71 +73 @@
     void sltRefreshAll();
 
-    /* Handlers: Medium-processing stuff: */
+    /** Handles VBoxGlobal::sigMediumCreated signal. */
     void sltHandleMediumCreated(const QString &strMediumID);
+    /** Handles VBoxGlobal::sigMediumDeleted signal. */
     void sltHandleMediumDeleted(const QString &strMediumID);
 
-    /* Handlers: Medium-enumeration stuff: */
+    /** Handles VBoxGlobal::sigMediumEnumerationStarted signal. */
     void sltHandleMediumEnumerationStart();
+    /** Handles VBoxGlobal::sigMediumEnumerated signal. */
     void sltHandleMediumEnumerated(const QString &strMediumID);
+    /** Handles VBoxGlobal::sigMediumEnumerationFinished signal. */
     void sltHandleMediumEnumerationFinish();
 
-    /* Handlers: Medium-modification stuff: */
+    /** Calls for clone VD wizard to copy chosen medium. */
     void sltCopyMedium();
+    /** Calls for medium-type change dialog for chosen medium. */
     void sltModifyMedium();
+    /** Calls for remove medium dialog for chosen medium. */
     void sltRemoveMedium();
+    /** Calls for medium release dialog for chosen medium. */
     void sltReleaseMedium();