Changeset 96266 in vbox for trunk

Timestamp:

Aug 17, 2022 1:43:26 PM (3 years ago)

Author:

vboxsync

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

153078

Message:

FE/Qt: Adding a new menu item to the 'Help' menu to let user to navigate to the user manual in OracleDocs.

Location:

trunk/src/VBox/Frontends/VirtualBox/src

Files:

• converter/UIConverterBackendGlobal.cpp (modified) (2 diffs)
• extradata/UIExtraDataDefs.h (modified) (1 diff)
• globals/UIActionPool.cpp (modified) (5 diffs)
• globals/UIActionPool.h (modified) (1 diff)
• globals/UIMessageCenter.cpp (modified) (1 diff)
• globals/UIMessageCenter.h (modified) (1 diff)

trunk/src/VBox/Frontends/VirtualBox/src/converter/UIConverterBackendGlobal.cpp

@@ -581 +581 @@
         case UIExtraDataMetaDefs::MenuHelpActionType_Forums:               strResult = "Forums"; break;
         case UIExtraDataMetaDefs::MenuHelpActionType_Oracle:               strResult = "Oracle"; break;
+        case UIExtraDataMetaDefs::MenuHelpActionType_OnlineManual:         strResult = "OnlineManual"; break;
 #ifndef VBOX_WS_MAC
         case UIExtraDataMetaDefs::MenuHelpActionType_About:                strResult = "About"; break;
@@ -608 +609 @@
     if (strMenuHelpActionType.compare("Oracle", Qt::CaseInsensitive) == 0)
         return UIExtraDataMetaDefs::MenuHelpActionType_Oracle;
+    if (strMenuHelpActionType.compare("OnlineManual", Qt::CaseInsensitive) == 0)
+        return UIExtraDataMetaDefs::MenuHelpActionType_OnlineManual;
 #ifndef VBOX_WS_MAC
     if (strMenuHelpActionType.compare("About", Qt::CaseInsensitive) == 0)

trunk/src/VBox/Frontends/VirtualBox/src/extradata/UIExtraDataDefs.h

@@ -555 +555 @@
         MenuHelpActionType_Forums               = RT_BIT(3),
         MenuHelpActionType_Oracle               = RT_BIT(4),
+        MenuHelpActionType_OnlineManual         = RT_BIT(5),
 #ifndef VBOX_WS_MAC
-        MenuHelpActionType_About                = RT_BIT(5),
+        MenuHelpActionType_About                = RT_BIT(6),
 #endif
         MenuHelpActionType_All                  = 0xFFFF

trunk/src/VBox/Frontends/VirtualBox/src/globals/UIActionPool.cpp

@@ -838 +838 @@
 };
 
+
 /** Simple action extension, used as 'Oracle' action class. */
 class UIActionSimpleOracle : public UIActionSimple
@@ -881 +882 @@
         setName(QApplication::translate("UIActionPool", "&Oracle Web Site..."));
         setStatusTip(QApplication::translate("UIActionPool", "Open the browser and go to the Oracle web site"));
+    }
+};
+
+
+/** Simple action extension, used as 'Online Manual' action class. */
+class UIActionSimpleOnlineManual : public UIActionSimple
+{
+    Q_OBJECT;
+
+public:
+
+    /** Constructs action passing @a pParent to the base-class. */
+    UIActionSimpleOnlineManual(UIActionPool *pParent)
+        : UIActionSimple(pParent, ":/site_oracle_16px.png", ":/site_oracle_16px.png", true)
+    {
+        retranslateUi();
+    }
+
+protected:
+
+    /** Returns action extra-data ID. */
+    virtual int extraDataID() const RT_OVERRIDE
+    {
+        return UIExtraDataMetaDefs::MenuHelpActionType_OnlineManual;
+    }
+    /** Returns action extra-data key. */
+    virtual QString extraDataKey() const RT_OVERRIDE
+    {
+        return gpConverter->toInternalString(UIExtraDataMetaDefs::MenuHelpActionType_OnlineManual);
+    }
+    /** Returns whether action is allowed. */
+    virtual bool isAllowed() const RT_OVERRIDE
+    {
+        return actionPool()->isAllowedInMenuHelp(UIExtraDataMetaDefs::MenuHelpActionType_OnlineManual);
+    }
+
+    /** Returns shortcut extra-data ID. */
+    virtual QString shortcutExtraDataID() const RT_OVERRIDE
+    {
+        return QString("OnlineManual");
+    }
+
+    /** Handles translation event. */
+    virtual void retranslateUi() RT_OVERRIDE
+    {
+        setName(QApplication::translate("UIActionPool", "&Online Manual..."));
+        setStatusTip(QApplication::translate("UIActionPool", "Open the browser and go to the VirtualBox user manual"));
     }
 };
@@ -3081 +3129 @@
     m_pool[UIActionIndex_Simple_Forums] = new UIActionSimpleForums(this);
     m_pool[UIActionIndex_Simple_Oracle] = new UIActionSimpleOracle(this);
+    m_pool[UIActionIndex_Simple_OnlineManual] = new UIActionSimpleOnlineManual(this);
 #ifndef VBOX_WS_MAC
     m_pool[UIActionIndex_Simple_About] = new UIActionSimpleAbout(this);
@@ -3203 +3252 @@
     connect(action(UIActionIndex_Simple_Oracle), &UIAction::triggered,
             &msgCenter(), &UIMessageCenter::sltShowOracle, Qt::UniqueConnection);
+    connect(action(UIActionIndex_Simple_OnlineManual), &UIAction::triggered,
+            &msgCenter(), &UIMessageCenter::sltShowOnlineManual, Qt::UniqueConnection);
 #ifndef VBOX_WS_MAC
     connect(action(UIActionIndex_Simple_About), &UIAction::triggered,
@@ -3466 +3517 @@
     /* 'Oracle' action: */
     fSeparator = addAction(pMenu, action(UIActionIndex_Simple_Oracle)) || fSeparator;
+    /* 'Online Manual' action: */
+    fSeparator = addAction(pMenu, action(UIActionIndex_Simple_OnlineManual)) || fSeparator;
 
     /* Separator? */

trunk/src/VBox/Frontends/VirtualBox/src/globals/UIActionPool.h

@@ -83 +83 @@
     UIActionIndex_Simple_Forums,
     UIActionIndex_Simple_Oracle,
+    UIActionIndex_Simple_OnlineManual,
 #ifndef VBOX_WS_MAC
     UIActionIndex_Simple_About,

trunk/src/VBox/Frontends/VirtualBox/src/globals/UIMessageCenter.cpp

@@ -2043 +2043 @@
 void UIMessageCenter::sltShowOracle()
 {
-    uiCommon().openURL("http://www.oracle.com/us/technologies/virtualization/virtualbox/overview/index.html");
+    uiCommon().openURL("https://www.oracle.com/us/technologies/virtualization/virtualbox/overview/index.html");
+}
+
+void UIMessageCenter::sltShowOnlineManual()
+{
+    uiCommon().openURL("https://docs.oracle.com/en/virtualization/virtualbox/7.0/user/index.html");
 }
 

trunk/src/VBox/Frontends/VirtualBox/src/globals/UIMessageCenter.h

@@ -451 +451 @@
     void sltShowForums();
     void sltShowOracle();
+    void sltShowOnlineManual();
     void sltShowHelpAboutDialog();
     void sltShowHelpHelpDialog();