Changeset 3806 in vbox for trunk/src/VBox/Frontends/VirtualBox/include

Timestamp:

Jul 24, 2007 11:06:48 AM (18 years ago)

Author:

vboxsync

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

23149

Message:

FE/Qt: Added VBoxAsyncEvent and VBoxGlobal::findWidget() helpers (see class docs for details).

Location:

trunk/src/VBox/Frontends/VirtualBox/include

Files:

• VBoxDefs.h (modified) (2 diffs)
• VBoxGlobal.h (modified) (2 diffs)

trunk/src/VBox/Frontends/VirtualBox/include/VBoxDefs.h

@@ -117 +117 @@
 
     /** VM display rendering mode. */
-    enum RenderMode {
+    enum RenderMode
+    {
         InvalidRenderMode, TimerMode, QImageMode, SDLMode, DDRAWMode
     };
 
     /** Additional Qt event types. */
-    enum {
-        ResizeEventType = QEvent::User,
+    enum
+    {
+        AsyncEventType = QEvent::User + 100,
+        ResizeEventType,
         RepaintEventType,
         SetRegionEventType,
@@ -137 +140 @@
         RuntimeErrorEventType,
         ModifierKeyChangeEventType,
-        EnumerateMediaEventType = QEvent::User + 100,
+        EnumerateMediaEventType,
 #if defined (Q_WS_WIN)
         ShellExecuteEventType,

trunk/src/VBox/Frontends/VirtualBox/include/VBoxGlobal.h

@@ -435 +435 @@
     static QString removeAccelMark (const QString &aText);
 
+    static QWidget *findWidget (QWidget *aParent, const char *aName,
+                                const char *aClassName = NULL,
+                                bool aRecursive = false);
+
 signals:
 
@@ -548 +552 @@
 inline VBoxGlobal &vboxGlobal() { return VBoxGlobal::instance(); }
 
+// Helper classes
+////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  Generic asyncronous event.
+ *
+ *  This abstract class is intended to provide a conveinent way to execute
+ *  code on the main GUI thread asynchronously to the calling party. This is
+ *  done by putting necessary actions to the #handle() function in a subclass
+ *  and then posting an instance of the subclass using #post(). The instance
+ *  must be allocated on the heap using the <tt>new</tt> operation and will be
+ *  automatically deleted after processing. Note that if you don't call #post()
+ *  on the created instance, you have to delete it yourself.
+ */
+class VBoxAsyncEvent : public QEvent
+{
+public:
+
+    VBoxAsyncEvent() : QEvent ((QEvent::Type) VBoxDefs::AsyncEventType) {}
+
+    /**
+     *  Worker function. Gets executed on the GUI thread when the posted event
+     *  is processed by the main event loop.
+     */
+    virtual void handle() = 0;
+
+    /**
+     *  Posts this event to the main event loop.
+     *  The caller loses ownership of this object after this method returns
+     *  and must not delete the object.
+     */
+    void post()
+    {
+        QApplication::postEvent (&vboxGlobal(), this);
+    }
+};
 
 /**