Changeset 103094 in vbox for trunk

Timestamp:

Jan 26, 2024 5:09:05 PM (13 months ago)

Author:

vboxsync

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

161340

Message:

FE/Qt: UIWelcomePane: bugref:10513: Extending UIWelcomePane with some info regarding Experience mode; Adding one-time choice as well.

Location:

trunk/src/VBox/Frontends/VirtualBox/src/manager

Files:

• UIWelcomePane.cpp (modified) (7 diffs)
• UIWelcomePane.h (modified) (3 diffs)

trunk/src/VBox/Frontends/VirtualBox/src/manager/UIWelcomePane.cpp

@@ -27 +27 @@
 
 /* Qt includes: */
+#include <QButtonGroup>
 #include <QGridLayout>
 #include <QLabel>
+#include <QPushButton>
 #include <QStyle>
 #include <QUrl>
@@ -37 +39 @@
 #include "UICommon.h"
 #include "UIDesktopWidgetWatchdog.h"
+#include "UIExtraDataManager.h"
 #include "UIIconPool.h"
 #include "UIWelcomePane.h"
@@ -48 +51 @@
     : QIWithRetranslateUI<QWidget>(pParent)
     , m_pLabelGreetings(0)
+    , m_pLabelMode(0)
     , m_pLabelIcon(0)
 {
@@ -88 +92 @@
                                       "for more information and latest news.</p>")
                                       .arg(QKeySequence(QKeySequence::HelpContents).toString(QKeySequence::NativeText)));
+
+    /* Translate experience mode stuff: */
+    if (m_pLabelMode)
+        m_pLabelMode->setText(tr("<h3>Please choose Experience Mode!</h3>"
+                                 "By default, the VirtualBox GUI is hiding some options, tools and wizards. "
+                                 "<p>The <b>Basic Mode</b> is intended for a users who are not interested in advanced "
+                                 "functionality and prefer a simpler, cleaner interface.</p>"
+                                 "<p>The <b>Expert Mode</b> is intended for experienced users who wish to utilize all "
+                                 "VirtualBox functionality.</p>"
+                                 "<p>You can choose whether you are a beginner or experienced user by selecting required "
+                                 "option at the right. This choice can always be changed in Global Preferences or Machine "
+                                 "Settings windows.</p>"));
+    if (m_buttons.contains(false))
+        m_buttons.value(false)->setText(tr("Basic Mode"));
+    if (m_buttons.contains(true))
+        m_buttons.value(true)->setText(tr("Expert Mode"));
 }
 
@@ -93 +113 @@
 {
     uiCommon().openURL(urlLink.toString());
+}
+
+void UIWelcomePane::sltHandleButtonClicked(QAbstractButton *pButton)
+{
+    /* Make sure one of buttons was really pressed: */
+    AssertReturnVoid(m_buttons.contains(pButton));
+
+    /* Hide everything related to experience mode: */
+    if (m_pLabelMode)
+        m_pLabelMode->hide();
+    if (m_buttons.contains(false))
+        m_buttons.value(false)->hide();
+    if (m_buttons.contains(true))
+        m_buttons.value(true)->hide();
+
+    /* Check which button was pressed actually and save the value: */
+    const bool fExpertMode = m_buttons.key(pButton, false);
+    gEDataManager->setSettingsInExpertMode(fExpertMode);
 }
 
@@ -115 +153 @@
         pMainLayout->setContentsMargins(iL, iT, iR, iB);
         pMainLayout->setSpacing(iSpacing);
-        pMainLayout->setRowStretch(1, 1);
+        pMainLayout->setRowStretch(2, 1);
 
         /* Prepare greetings label: */
@@ -132 +170 @@
             m_pLabelIcon->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Fixed);
             pMainLayout->addWidget(m_pLabelIcon, 0, 1);
+        }
+
+        /* This block for the case if experienced mode is NOT defined yet: */
+        if (gEDataManager->extraDataString(UIExtraDataDefs::GUI_Settings_ExpertMode).isNull())
+        {
+            /* Prepare experience mode label: */
+            m_pLabelMode = new QIRichTextLabel(this);
+            if (m_pLabelMode)
+            {
+                m_pLabelMode->setSizePolicy(QSizePolicy::MinimumExpanding, QSizePolicy::Minimum);
+                pMainLayout->addWidget(m_pLabelMode, 1, 0);
+            }
+
+            /* Prepare button layout: */
+            QVBoxLayout *pLayoutButton = new QVBoxLayout;
+            if (pLayoutButton)
+            {
+                pLayoutButton->setSpacing(iSpacing / 2);
+
+                /* Prepare button group: */
+                QButtonGroup *pButtonGroup = new QButtonGroup(this);
+                if (pButtonGroup)
+                {
+                    /* Prepare Basic button ('false' means 'not Expert'): */
+                    m_buttons[false] = new QPushButton(this);
+                    QAbstractButton *pButtonBasic = m_buttons.value(false);
+                    if (pButtonBasic)
+                    {
+                        pButtonGroup->addButton(pButtonBasic);
+                        pLayoutButton->addWidget(pButtonBasic);
+                    }
+
+                    /* Prepare Expert button ('true' means 'is Expert'): */
+                    m_buttons[true] = new QPushButton(this);
+                    QAbstractButton *pButtonExpert = m_buttons[true];
+                    if (pButtonExpert)
+                    {
+                        pButtonGroup->addButton(pButtonExpert);
+                        pLayoutButton->addWidget(pButtonExpert);
+                    }
+
+                    connect(pButtonGroup, &QButtonGroup::buttonClicked,
+                            this, &UIWelcomePane::sltHandleButtonClicked);
+                }
+
+                pLayoutButton->addStretch();
+                pMainLayout->addLayout(pLayoutButton, 1, 1);
+            }
         }
     }

trunk/src/VBox/Frontends/VirtualBox/src/manager/UIWelcomePane.h

@@ -40 +40 @@
 
 /* Forward declarations: */
+class QAbstractButton;
 class QLabel;
 class QIRichTextLabel;
@@ -66 +67 @@
     void sltHandleLinkActivated(const QUrl &urlLink);
 
+    /** Handles @a pButton click. */
+    void sltHandleButtonClicked(QAbstractButton *pButton);
+
 private:
 
@@ -80 +84 @@
 
     /** Holds the greetings label instance. */
-    QIRichTextLabel *m_pLabelGreetings;
+    QIRichTextLabel              *m_pLabelGreetings;
+    /** Holds the mode label instance. */
+    QIRichTextLabel              *m_pLabelMode;
+    /** Holds a list of experience mode button instances. */
+    QMap<bool, QAbstractButton*>  m_buttons;
     /** Holds the icon label instance. */
-    QLabel          *m_pLabelIcon;
+    QLabel                       *m_pLabelIcon;
 };