Changeset 52987 in vbox

Timestamp:

Oct 8, 2014 10:58:38 AM (10 years ago)

Author:

vboxsync

Message:

FE/Qt: Runtime UI rework/cleanup for 7115 (part #4): UIMachine doxy.

Location:

trunk/src/VBox/Frontends/VirtualBox/src/runtime

Files:

trunk/src/VBox/Frontends/VirtualBox/src/runtime/UIMachine.cpp

-              r52977
+              r52987
     machineLogic()->initializePostPowerUp();
+    /* True by default: */
     return true;
+}
 …
 QWidget* UIMachine::activeWindow() const
+{
+    /* Null if machine-logic not yet created: */
+    if (!machineLogic())
+        return 0;
+    /* Active machine-window otherwise: */
+    return machineLogic()->activeMachineWindow();
+    if (machineLogic() &&  machineLogic()->activeMachineWindow())
+        return machineLogic()->activeMachineWindow();
+    return 0;
+}

-              r52977
+              r52987
 class UIMachineLogic;
+/** Singleton QObject extension
+  * used as virtual machine (VM) singleton instance. */
 class UIMachine : public QObject
+{
 …
     UIMachine();
     /** Destructor. */
     virtual ~UIMachine();
+    ~UIMachine();
     /* Public getters: */
+    /** Returns active machine-window reference (if possible). */
     QWidget* activeWindow() const;
+    /** Returns UI session instance. */
     UISession *uisession() const { return m_pSession; }
 …
 private slots:
     /* Visual state-change handler: */
+    /** Visual state-change handler. */
     void sltChangeVisualState(UIVisualStateType visualStateType);
 private:
+    /** Prepare routine. */
     bool prepare();
     /* Move VM to default (normal) state: */
+    /** Moves VM to default (normal) state. */
     void enterInitialVisualState();
     /* Private getters: */
+    /** Returns machine-logic reference (if possible). */
     UIMachineLogic* machineLogic() const;
     /* Prepare helpers: */
+    /** Prepare routine: Loading stuff. */
     void loadMachineSettings();
     /* Cleanup helpers: */
+    /** Prepare routine: Saving stuff. */
     void saveMachineSettings();
 …
 #endif /* !___UIMachine_h___ */

Note: See TracChangeset for help on using the changeset viewer.