Changeset 64080 in vbox

Timestamp:

Sep 28, 2016 1:12:04 PM (8 years ago)

Author:

vboxsync

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

111016

Message:

FE/Qt: bugref:6899: Accessibility support (step 58): Continuing with the r110986.

Location:

trunk/src/VBox/Frontends/VirtualBox/src/settings

Files:

• UISettingsSelector.cpp (modified) (9 diffs)
• UISettingsSelector.h (modified) (2 diffs)

trunk/src/VBox/Frontends/VirtualBox/src/settings/UISettingsSelector.cpp

@@ -37 +37 @@
 
 
-/** Tree-widget column categories. */
+/** Tree-widget column sections. */
 enum
 {
@@ -51 +51 @@
 public:
 
+    /** Constructs selector item.
+      * @param  aIcon      Brings the item icon.
+      * @param  aText      Brings the item text.
+      * @param  aId        Brings the item ID.
+      * @param  aLink      Brings the item link.
+      * @param  aPage      Brings the item page reference.
+      * @param  aParentId  Brings the item parent ID. */
     SelectorItem (const QIcon &aIcon, const QString &aText, int aId, const QString &aLink, UISettingsPage* aPage, int aParentId)
         : mIcon (aIcon)
@@ -60 +67 @@
     {}
 
+    /** Returns the item icon. */
     QIcon icon() const { return mIcon; }
+    /** Returns the item text. */
     QString text() const { return mText; }
+    /** Defines the item @s strText. */
     void setText (const QString &aText) { mText = aText; }
+    /** Returns the item ID. */
     int id() const { return mId; }
+    /** Returns the item link. */
     QString link() const { return mLink; }
+    /** Returns the item page reference. */
     UISettingsPage *page() const { return mPage; }
+    /** Returns the item parent ID. */
     int parentId() const { return mParentId; }
 
 protected:
 
+    /** Holds the item icon. */
     QIcon mIcon;
+    /** Holds the item text. */
     QString mText;
+    /** Holds the item ID. */
     int mId;
+    /** Holds the item link. */
     QString mLink;
+    /** Holds the item page reference. */
     UISettingsPage* mPage;
+    /** Holds the item parent ID. */
     int mParentId;
 };
@@ -194 +214 @@
 {
     mTwSelector = new QITreeWidget (aParent);
-    /* Configure the selector */
+    /* Configure the selector: */
     QSizePolicy sizePolicy (QSizePolicy::Minimum, QSizePolicy::Expanding);
     sizePolicy.setHorizontalStretch (0);
@@ -207 +227 @@
     mTwSelector->setUniformRowHeights (true);
     mTwSelector->setIconSize(QSize((int)(1.5 * iIconMetric), (int)(1.5 * iIconMetric)));
-    /* Add the columns */
+    /* Add the columns: */
     mTwSelector->headerItem()->setText (treeWidget_Category, "Category");
     mTwSelector->headerItem()->setText (treeWidget_Id, "[id]");
     mTwSelector->headerItem()->setText (treeWidget_Link, "[link]");
-    /* Hide unnecessary columns and header */
+    /* Hide unnecessary columns and header: */
     mTwSelector->header()->hide();
     mTwSelector->hideColumn (treeWidget_Id);
     mTwSelector->hideColumn (treeWidget_Link);
-    /* Setup connections */
+    /* Setup connections: */
     connect (mTwSelector, SIGNAL (currentItemChanged (QTreeWidgetItem*, QTreeWidgetItem*)),
              this, SLOT (settingsGroupChanged (QTreeWidgetItem *, QTreeWidgetItem*)));
@@ -373 +393 @@
 public:
 
+    /** Constructs selector item.
+      * @param  aIcon      Brings the item icon.
+      * @param  aText      Brings the item text.
+      * @param  aId        Brings the item ID.
+      * @param  aLink      Brings the item link.
+      * @param  aPage      Brings the item page reference.
+      * @param  aParentId  Brings the item parent ID.
+      * @param  aParent    Brings the item parent. */
     SelectorActionItem (const QIcon &aIcon, const QString &aText, int aId, const QString &aLink, UISettingsPage* aPage, int aParentId, QObject *aParent)
         : SelectorItem (aIcon, aText, aId, aLink, aPage, aParentId)
@@ -381 +409 @@
     }
 
+    /** Returns the action instance. */
     QAction *action() const { return mAction; }
 
+    /** Defines the @a pTabWidget instance. */
     void setTabWidget (QTabWidget *aTabWidget) { mTabWidget = aTabWidget; }
+    /** Returns the tab-widget instance. */
     QTabWidget *tabWidget() const { return mTabWidget; }
 
 protected:
 
+    /** Holds the action instance. */
     QAction *mAction;
+    /** Holds the tab-widget instance. */
     QTabWidget *mTabWidget;
 };
@@ -396 +429 @@
     : UISettingsSelector (aParent)
 {
-    /* Init the toolbar */
+    /* Init the toolbar: */
     mTbSelector = new UIToolBar (aParent);
     mTbSelector->setUseTextLabels (true);
@@ -403 +436 @@
     mTbSelector->setShowToolBarButton (false);
 #endif /* VBOX_WS_MAC */
-    /* Init the action group for house keeping */
+    /* Init the action group for house keeping: */
     mActionGroup = new QActionGroup (this);
     mActionGroup->setExclusive (true);

trunk/src/VBox/Frontends/VirtualBox/src/settings/UISettingsSelector.h

@@ -103 +103 @@
 signals:
 
-    /** Notifies listeners about selector section changed. */
-    void categoryChanged (int);
+    /** Notifies listeners about selector @a iCategory changed. */
+    void categoryChanged (int iCategory);
 
 protected:
@@ -186 +186 @@
     QString idToString (int aId) const;
 
-    /** Holds the tree-widget selector instance. */
+    /** Holds the tree-widget instance. */
     QITreeWidget *mTwSelector;
 };