Changeset 1370 in vbox

Timestamp:

Mar 9, 2007 1:12:43 PM (18 years ago)

Author:

vboxsync

Message:

FE/Qt: Added VBoxGlobal::openURL(); implemented Help -> VirtualBox Web Site.

Location:

trunk/src/VBox/Frontends/VirtualBox

Files:

• include/VBoxDefs.h (modified) (1 diff)
• include/VBoxGlobal.h (modified) (1 diff)
• include/VBoxProblemReporter.h (modified) (1 diff)
• src/VBoxGlobal.cpp (modified) (4 diffs)
• src/VBoxProblemReporter.cpp (modified) (2 diffs)

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

@@ -123 +123 @@
     /** Additional Qt event types. */
     enum {
-        ResizeEventType = QEvent::User + 0,
-        RepaintEventType = QEvent::User + 1,
-        MouseCapabilityEventType = QEvent::User + 2,
-        MousePointerChangeEventType = QEvent::User + 3,
-        MachineStateChangeEventType = QEvent::User + 4,
-        MachineDataChangeEventType = QEvent::User + 5,
-        MachineRegisteredEventType = QEvent::User + 6,
-        SessionStateChangeEventType = QEvent::User + 7,
-        SnapshotEventType = QEvent::User + 8,
-        RuntimeErrorEventType = QEvent::User + 9,
-        ModifierKeyChangeEventType = QEvent::User + 10,
+        ResizeEventType = QEvent::User,
+        RepaintEventType,
+        MouseCapabilityEventType,
+        MousePointerChangeEventType,
+        MachineStateChangeEventType,
+        MachineDataChangeEventType,
+        MachineRegisteredEventType,
+        SessionStateChangeEventType,
+        SnapshotEventType,
+        RuntimeErrorEventType,
+        ModifierKeyChangeEventType,
         EnumerateMediaEventType = QEvent::User + 100,
-        ActivateMenuEventType = QEvent::User + 101,
+#if defined (Q_WS_WIN)
+        ShellExecuteEventType,
+#endif
+        ActivateMenuEventType,
     };
 };

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

@@ -359 +359 @@
     /* various helpers */
 
+    bool openURL (const QString &aURL);
+
     void languageChange();
 

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

@@ -96 +96 @@
     // problem handlers
 
+    void cannotOpenURL (const QString &aURL);
+
     void cannotInitCOM (HRESULT rc);
     void cannotCreateVirtualBox (const CVirtualBox &vbox);

trunk/src/VBox/Frontends/VirtualBox/src/VBoxGlobal.cpp

@@ -39 +39 @@
 #include <qregexp.h>
 #include <qlocale.h>
+#include <qprocess.h>
+
+#ifdef Q_WS_MAC
+#include <Carbon/Carbon.h> // for HIToolbox/InternetConfig
+#endif
 
 #if defined (VBOX_GUI_DEBUG)
@@ -69 +74 @@
     const int mIndex;
 };
+
+#if defined (Q_WS_WIN)
+class VBoxShellExecuteEvent : public QEvent
+{
+public:
+
+    /** Constructs a regular enum event */
+    VBoxShellExecuteEvent (QThread *aThread, const QString &aURL,
+                             bool aOk)
+        : QEvent ((QEvent::Type) VBoxDefs::ShellExecuteEventType)
+        , mThread (aThread), mURL (aURL), mOk (aOk)
+        {}
+
+    QThread *mThread;
+    QString mURL;
+    bool mOk;
+};
+#endif
 
 // VirtualBox callback class
@@ -1332 +1355 @@
 }
 
+/** 
+ * Opens the specified URL using OS/Desktop capabilities.
+ * 
+ * @param aURL URL to open
+ * 
+ * @return true on success and false otherwise
+ */
+bool VBoxGlobal::openURL (const QString &aURL)
+{
+#if defined (Q_WS_WIN)
+    /* We cannot use ShellExecute() on the main UI thread because we've
+     * initialized COM with CoInitializeEx(COINIT_MULTITHREADED). See
+     * http://support.microsoft.com/default.aspx?scid=kb;en-us;287087
+     * for more details. */
+    class Thread : public QThread
+    {
+    public:
+
+        Thread (const QString &aURL, QObject *aObject)
+            : mObject (aObject), mURL (aURL) {}
+
+        void run()
+        {
+            int rc = (int) ShellExecute (NULL, NULL, mURL.ucs2(), NULL, NULL, SW_SHOW);
+            bool ok = rc > 32;
+            QApplication::postEvent
+                (mObject,
+                 new VBoxShellExecuteEvent (this, mURL, ok));
+        }
+
+        QString mURL;
+        QObject *mObject;
+    };
+
+    Thread *thread = new Thread (aURL, this);
+    thread->start();
+    /* thread will be deleted in the VBoxShellExecuteEvent handler */
+
+    return true;
+
+#elif defined (Q_WS_X11)
+
+    static const char * const commands[] =
+        { "gnome-open", "kfmclient:exec", "x-www-browser", "firefox", "konqueror" };
+
+    for (size_t i = 0; i < ELEMENTS (commands); ++ i)
+    {
+        QStringList args = QStringList::split (':', commands [i]);
+        args += aURL;
+        QProcess cmd (args);
+        if (cmd.start())
+            return true;
+    }
+
+#elif defined (Q_WS_MAC)
+
+    /* The code below is taken from Psi 0.10 sources
+     * (http://www.psi-im.org) */
+
+    /* Use Internet Config to hand the URL to the appropriate application, as
+     * set by the user in the Internet Preferences pane.
+     * NOTE: ICStart could be called once at Psi startup, saving the
+     *       ICInstance in a global variable, as a minor optimization.
+     *       ICStop should then be called at Psi shutdown if ICStart
+     *       succeeded. */
+    ICInstance icInstance;
+    OSType psiSignature = 'psi ';
+    OSStatus error = ::ICStart (&icInstance, psiSignature);
+    if (error == noErr)
+    {
+        ConstStr255Param hint (0x0);
+        QCString cs = aURL.local8Bit();
+        const char* data = cs.data();
+        long length = cs.length();
+        long start (0);
+        long end (length);
+        /* Don't bother testing return value (error); launched application
+         * will report problems. */
+        ::ICLaunchURL (icInstance, hint, data, length, &start, &end);
+        ICStop (icInstance);
+    }
+
+#else
+    vboxProblem().message
+        (NULL, VBoxProblemReporter::Error,
+         tr ("Opening URLs is not implemented yet."));
+    return false;
+#endif
+
+    /* if we go here it means we couldn't open the URL */
+    vboxProblem().cannotOpenURL (aURL);
+
+    return false;
+}
+
 /**
  *  Changes the language of all global string constants according to the
@@ -1866 +1984 @@
     switch (e->type())
     {
+#if defined (Q_WS_WIN)
+        case VBoxDefs::ShellExecuteEventType:
+        {
+            VBoxShellExecuteEvent *ev = (VBoxShellExecuteEvent *) e;
+            if (!ev->mOk)
+                vboxProblem().cannotOpenURL (ev->mURL);
+            /* wait for the thread and free resources */
+            ev->mThread->wait();
+            delete ev->mThread;
+            return true;
+        }
+#endif
+
         case VBoxDefs::EnumerateMediaEventType:
         {

trunk/src/VBox/Frontends/VirtualBox/src/VBoxProblemReporter.cpp

@@ -437 +437 @@
 /////////////////////////////////////////////////////////////////////////////
 
+void VBoxProblemReporter::cannotOpenURL (const QString &aURL)
+{
+    message
+        (mainWindowShown(), VBoxProblemReporter::Error,
+         tr ("Failed to open <tt>%1</tt>. Make sure your desktop environment "
+             "can properly handle URLs of this type.")
+         .arg (aURL));
+}
+
 void VBoxProblemReporter::cannotInitCOM (HRESULT rc)
 {
@@ -1551 +1560 @@
 void VBoxProblemReporter::showHelpWebDialog()
 {
+    vboxGlobal().openURL ("http://www.virtualbox.org");
 }