Changeset 64109 in vbox for trunk/src

Timestamp:

Sep 30, 2016 1:16:49 PM (8 years ago)

Author:

vboxsync

Message:

FE/Qt: bugref:6899: Accessibility support (step 65): Cleanup for QITreeWidget.

Location:

trunk/src/VBox/Frontends/VirtualBox/src/extensions

Files:

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

trunk/src/VBox/Frontends/VirtualBox/src/extensions/QITreeWidget.cpp

@@ -20 +20 @@
 #else  /* !VBOX_WITH_PRECOMPILED_HEADERS */
 
-/* Global includes */
+/* Qt includes: */
 # include <QPainter>
 # include <QResizeEvent>
 
-/* Local includes */
+/* GUI includes: */
 # include "QITreeWidget.h"
 
@@ -30 +30 @@
 
 
-QITreeWidget::QITreeWidget (QWidget *aParent)
-    : QTreeWidget (aParent)
+QITreeWidget::QITreeWidget(QWidget *aParent)
+    : QTreeWidget(aParent)
 {
 }
@@ -37 +37 @@
 void QITreeWidget::setSizeHintForItems(const QSize &sizeHint)
 {
+    /* Pass the sizeHint to all the top-level items: */
     for (int i = 0; i < topLevelItemCount(); ++i)
         topLevelItem(i)->setSizeHint(0, sizeHint);
 }
 
-void QITreeWidget::paintEvent (QPaintEvent *aEvent)
+void QITreeWidget::paintEvent(QPaintEvent *pEvent)
 {
-    /* Opens Items Painter */
+    /* Create item painter: */
     QPainter painter;
-    painter.begin (viewport());
+    painter.begin(viewport());
 
-    /* Notify connected objects about painting */
-    QTreeWidgetItemIterator it (this);
+    /* Notify listeners about painting: */
+    QTreeWidgetItemIterator it(this);
     while (*it)
     {
-        emit painted (*it, &painter);
-        ++ it;
+        emit painted(*it, &painter);
+        ++it;
     }
 
-    /* Close Items Painter */
+    /* Close item painter: */
     painter.end();
 
-    /* Base-class paint-event */
-    QTreeWidget::paintEvent (aEvent);
+    /* Call to base-class: */
+    QTreeWidget::paintEvent(pEvent);
 }
 
-void QITreeWidget::resizeEvent (QResizeEvent *aEvent)
+void QITreeWidget::resizeEvent(QResizeEvent *pEvent)
 {
-    /* Base-class resize-event */
-    QTreeWidget::resizeEvent (aEvent);
+    /* Call to base-class: */
+    QTreeWidget::resizeEvent(pEvent);
 
-    /* Notify connected objects about resize */
-    emit resized (aEvent->size(), aEvent->oldSize());
+    /* Notify listeners about resizing: */
+    emit resized(pEvent->size(), pEvent->oldSize());
 }
 

trunk/src/VBox/Frontends/VirtualBox/src/extensions/QITreeWidget.h

@@ -16 +16 @@
  */
 
-#ifndef __QITreeWidget_h__
-#define __QITreeWidget_h__
+#ifndef ___QITreeWidget_h___
+#define ___QITreeWidget_h___
 
-/* Global includes */
+/* Qt includes: */
 #include <QTreeWidget>
 
-/*
- * QTreeWidget class which extends standard QTreeWidget's functionality.
- */
-class QITreeWidget: public QTreeWidget
+
+/** QTreeWidget subclass extending standard functionality. */
+class QITreeWidget : public QTreeWidget
 {
     Q_OBJECT;
 
+signals:
+
+    /** Notifies about particular tree-widget @a pItem is painted with @a pPainter. */
+    void painted(QTreeWidgetItem *pItem, QPainter *pPainter);
+    /** Notifies about tree-widget being resized from @a oldSize to @a size. */
+    void resized(const QSize &size, const QSize &oldSize);
+
 public:
 
-    QITreeWidget (QWidget *aParent = 0);
+    /** Constructs tree-widget passing @a pParent to the base-class. */
+    QITreeWidget(QWidget *pParent = 0);
 
+    /** Defines @a sizeHint for tree-widget items. */
     void setSizeHintForItems(const QSize &sizeHint);
-
-signals:
-
-    void painted (QTreeWidgetItem *aItem, QPainter *aPainter);
-    void resized (const QSize &aSize, const QSize &aOldSize);
 
 protected:
 
-    void paintEvent (QPaintEvent *aEvent);
-    void resizeEvent (QResizeEvent *aEvent);
+    /** Handles paint @a pEvent. */
+    void paintEvent(QPaintEvent *pEvent);
+    /** Handles resize @a pEvent. */
+    void resizeEvent(QResizeEvent *pEvent);
 };
 
-#endif /* __QITreeWidget_h__ */
+#endif /* !___QITreeWidget_h___ */