Index: /trunk/src/VBox/Frontends/VirtualBox/src/widgets/UIScaleFactorEditor.cpp
===================================================================
--- /trunk/src/VBox/Frontends/VirtualBox/src/widgets/UIScaleFactorEditor.cpp	(revision 75371)
+++ /trunk/src/VBox/Frontends/VirtualBox/src/widgets/UIScaleFactorEditor.cpp	(revision 75372)
@@ -5,5 +5,5 @@
 
 /*
- * Copyright (C) 2009-2017 Oracle Corporation
+ * Copyright (C) 2009-2018 Oracle Corporation
  *
  * This file is part of VirtualBox Open Source Edition (OSE), as
Index: /trunk/src/VBox/Frontends/VirtualBox/src/widgets/UIScaleFactorEditor.h
===================================================================
--- /trunk/src/VBox/Frontends/VirtualBox/src/widgets/UIScaleFactorEditor.h	(revision 75371)
+++ /trunk/src/VBox/Frontends/VirtualBox/src/widgets/UIScaleFactorEditor.h	(revision 75372)
@@ -5,5 +5,5 @@
 
 /*
- * Copyright (C) 2009-2017 Oracle Corporation
+ * Copyright (C) 2009-2018 Oracle Corporation
  *
  * This file is part of VirtualBox Open Source Edition (OSE), as
@@ -19,10 +19,9 @@
 #define ___UIScaleFactorEditor_h___
 
-/** GUI includes. */
+/* GUI includes: */
 #include "QIWithRetranslateUI.h"
 #include "UILibraryDefs.h"
 
-
-/** Forward declarations. */
+/* Forward declarations: */
 class QComboBox;
 class QGridLayout;
@@ -33,6 +32,6 @@
 
 /** QWidget reimplementation providing GUI with monitor scale factor editing functionality.
-  *  It includes a combo box to select a monitor, a slider, and a spinbox to display/modify values.
-  *  The first item in the combo box is used to change the scale factor of all monitors. */
+  * It includes a combo box to select a monitor, a slider, and a spinbox to display/modify values.
+  * The first item in the combo box is used to change the scale factor of all monitors. */
 class SHARED_LIBRARY_STUFF UIScaleFactorEditor : public QIWithRetranslateUI<QWidget>
 {
@@ -41,17 +40,24 @@
 public:
 
+    /** Creates scale factor editor passing @a pParent to the base-class. */
     UIScaleFactorEditor(QWidget *pParent);
-    /** Configures the internal variables (m_pMonitorComboBox items , m_scaleFactors' size, etc)
-      * wrt. @p iMonitorCount. */
-    void           setMonitorCount(int iMonitorCount);
-    void           setScaleFactors(const QList<double> &scaleFactors);
+
+    /** Defines @a iMonitorCount. */
+    void setMonitorCount(int iMonitorCount);
+    /** Defines a list of guest-screen @a scaleFactors. */
+    void setScaleFactors(const QList<double> &scaleFactors);
+
     /** Returns either a single global scale factor or a list of scale factor for each monitor. */
-    QList<double>  scaleFactors() const;
-    void           setDefaultScaleFactor(double dDefaultScaleFactor);
+    QList<double> scaleFactors() const;
+
+    /** Defines @a dDefaultScaleFactor. */
+    void setDefaultScaleFactor(double dDefaultScaleFactor);
+
     /** Defines minimum width @a iHint for internal spin-box. */
-    void           setSpinBoxWidthHint(int iHint);
+    void setSpinBoxWidthHint(int iHint);
 
 protected:
 
+    /** Handles translation event. */
     virtual void retranslateUi() /* override */;
 
@@ -60,34 +66,40 @@
     /** @name Internal slots handling respective widget's value update.
       * @{ */
-        void sltScaleSpinBoxValueChanged(int value);
-        void sltScaleSliderValueChanged(int value);
-        void sltMonitorComboIndexChanged(int index);
+        void sltScaleSpinBoxValueChanged(int iValue);
+        void sltScaleSliderValueChanged(int iValue);
+        void sltMonitorComboIndexChanged(int iIndex);
     /** @} */
 
 private:
 
-    void               prepare();
-    void               setIsGlobalScaleFactor(bool bFlag);
-    void               setScaleFactor(int iMonitorIndex, int iScaleFactor);
-    /** Blocks slider's signals before settting the slider value. */
-    void               setSliderValue(int iValue);
-    /** Blocks spinbox's signals before settting the value. */
-    void               setSpinBoxValue(int iValue);
-    /** Set the spinbox and slider to scale factor of currently selected monitor. */
-    void               updateValuesAfterMonitorChange();
+    /** Prepares all. */
+    void prepare();
+
+    /** Defines whether scale factor is @a fGlobal one. */
+    void setIsGlobalScaleFactor(bool fGlobal);
+    /** Defines @a iScaleFactor for certain @a iMonitorIndex. */
+    void setScaleFactor(int iMonitorIndex, int iScaleFactor);
+    /** Defines slider's @a iValue. */
+    void setSliderValue(int iValue);
+    /** Defines spinbox's @a iValue. */
+    void setSpinBoxValue(int iValue);
+
+    /** Sets the spinbox and slider to scale factor of currently selected monitor. */
+    void updateValuesAfterMonitorChange();
 
     /** @name Member widgets.
       * @{ */
-        QSpinBox          *m_pScaleSpinBox;
-        QGridLayout       *m_pMainLayout;
-        QComboBox         *m_pMonitorComboBox;
-        QIAdvancedSlider  *m_pScaleSlider;
-        QLabel            *m_pMaxScaleLabel;
-        QLabel            *m_pMinScaleLabel;
+        QSpinBox         *m_pScaleSpinBox;
+        QGridLayout      *m_pMainLayout;
+        QComboBox        *m_pMonitorComboBox;
+        QIAdvancedSlider *m_pScaleSlider;
+        QLabel           *m_pMaxScaleLabel;
+        QLabel           *m_pMinScaleLabel;
     /** @} */
 
-    /** Stores the per-monitor scale factors. The 0th item is for all monitors (global). */
-    QList<double>      m_scaleFactors;
-    double             m_dDefaultScaleFactor;
+    /** Holds the per-monitor scale factors. The 0th item is for all monitors (global). */
+    QList<double>  m_scaleFactors;
+    /** Holds the default scale factor. */
+    double         m_dDefaultScaleFactor;
 };