feat: Add NetPlugin right-click menu function (DDE)

Author: XMuli

dde-dock-plugin/NetPlugin.cpp

@@ -4,6 +4,7 @@
 
 #include "NetPlugin.h"
 #include <QLabel>
+
 #include <QDebug>
 
 DWIDGET_USE_NAMESPACE
@@ -22,7 +23,7 @@ NetPlugin::NetPlugin(QObject *parent)
  */
 const QString NetPlugin::pluginName() const
 {
-    return "datetime"; // MonitorNet
+    return "datetime";
 }
 
 /*!
@@ -49,24 +50,92 @@ QWidget *NetPlugin::itemWidget(const QString &itemKey)
     return m_winDockNet;
 }
 
+/*!
+ * \brief NetPlugin::pluginIsAllowDisable 插件是否允许被禁用
+ * \return 告诉 dde-dock 本插件允许禁用
+ */
+bool NetPlugin::pluginIsAllowDisable()
+{
+    return true;
+}
+
+/*!
+ * \brief NetPlugin::pluginIsDisable 插件是否被禁用
+ * \return 插件是否被禁用的状态
+ * \note getValue() 的第二个参数 “disabled” 表示存储这个值的键（所有配置都是以键值对的方式存储的）
+ *       第三个参数表示默认值，即默认不禁用
+ */
+bool NetPlugin::pluginIsDisable()
+{
+    return m_proxyInter->getValue(this, "disabled", false).toBool();
+}
+
+/*!
+ * \brief NetPlugin::pluginStateSwitched 插件状态切换
+ */
+void NetPlugin::pluginStateSwitched()
+{
+    // 将旧的 "禁用状态" 数值取反后,保存到 key-val 中
+    const bool disableState = !pluginIsDisable();
+    m_proxyInter->saveValue(this, "disabled", disableState);
+
+    // 根据新的禁用状态值,处理主控的加载与卸载
+    if (disableState)
+        m_proxyInter->itemRemoved(this, pluginName());
+    else
+        m_proxyInter->itemAdded(this, pluginName());
+}
+
+/*!
+ * \brief NetPlugin::pluginDisplayName 插件在 dock 的右键时候，显示名称
+ * \return 插件在 dock 右键显示的预称
+ */
+const QString NetPlugin::pluginDisplayName() const
+{
+    return QString("MonitorNet");
+}
+
+/*!
+ * \brief NetPlugin::itemContextMenu 插件右键后现实的菜单列表
+ * \param itemKey
+ * \return 返回 JSON 格式的菜单数据
+ * \note 增加右键菜单功能需要实现此两个接口：itemContextMenu + invokedMenuItem
+ */
 const QString NetPlugin::itemContextMenu(const QString &itemKey)
 {
     Q_UNUSED(itemKey);
 
-    QList<QVariant> items;
-    items.reserve(1);
-
     QMap<QString, QVariant> update;
     update["itemId"] = "update";
     update["itemText"] = "刷新";
     update["isActive"] = true;
+
+    QList<QVariant> items;
+    items.reserve(1);
     items.push_back(update);
 
     QMap<QString, QVariant> menu;
     menu["items"] = items;
     menu["checkableMenu"] = false;
     menu["singleCheck"] = false;
 
-    // 返回 JSON 格式的菜单数据
     return QJsonDocument::fromVariant(menu).toJson();
 }
+
+/*!
+ * \brief NetPlugin::invokedMenuItem 菜单项被点击后的回调函数
+ * \param itemKey
+ * \param menuId  menu item ID
+ * \param checked
+ * \note * \note 增加右键菜单功能需要实现此两个接口：itemContextMenu + invokedMenuItem
+ */
+void NetPlugin::invokedMenuItem(const QString &itemKey, const QString &menuId, const bool checked)
+{
+    Q_UNUSED(itemKey)
+    Q_UNUSED(checked)
+
+    if (menuId == "update") {
+        m_proxyInter->itemRemoved(this, pluginName());
+        m_proxyInter->itemAdded(this, pluginName());
+    }
+}

dde-dock-plugin/NetPlugin.h

@@ -9,7 +9,6 @@
 #include <pluginsiteminterface.h>
 #include <dtkwidget_global.h>
 #include "WinDockNet.h"
-//#include "../widgets/WinDockNet.h"
 
 DWIDGET_USE_NAMESPACE
 
@@ -28,12 +27,24 @@ class NetPlugin : public QObject, public PluginsItemInterface
     virtual void init(PluginProxyInterface *proxyInter) override;
     virtual QWidget *itemWidget(const QString &itemKey) override;
 
+    // 插件禁用和启用相关的接口
+    virtual bool pluginIsAllowDisable() override;
+    virtual bool pluginIsDisable() override;
+    virtual void pluginStateSwitched() override;
+
+    // 其它额外接口
+    virtual const QString pluginDisplayName() const override;
     virtual const QString itemContextMenu(const QString &itemKey) override;
+    virtual void invokedMenuItem(const QString &itemKey, const QString &menuId, const bool checked) override;
 
 private:
     WinDockNet *m_winDockNet;
     PluginProxyInterface *m_proxyInter;
 
+
+
+    // PluginsItemInterface interface
+public:
 };
 
 #endif //LFXNET_NETPLUGIN_H

dde-dock-plugin/WinDockNet.h

@@ -23,7 +23,6 @@ class WinDockNet : public QWidget
 
     void init();
 
-
 public slots:
     void onNet();
     void onCpu();