File indexing completed on 2024-04-21 05:01:47

 /*
     The network neighborhood browser dock widget
 
     SPDX-FileCopyrightText: 2018-2023 Alexander Reinholdt <alexander.reinholdt@kdemail.net>
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #ifndef SMB4KNETWORKBROWSERDOCKWIDGET_H
 #define SMB4KNETWORKBROWSERDOCKWIDGET_H
 
 // application specific includes
 #include "core/smb4kglobal.h"
 
 // Qt includes
 #include <QDockWidget>
 #include <QPointer>
 #include <QTreeWidgetItem>
 
 // KDE includes
 #include <KActionCollection>
 #include <KActionMenu>
 
 using namespace Smb4KGlobal;
 
 // Forward declarations
 class Smb4KNetworkBrowser;
 class Smb4KNetworkSearchToolBar;
 class Smb4KPasswordDialog;
 
 class Smb4KNetworkBrowserDockWidget : public QDockWidget
 {
     Q_OBJECT
 
 public:
     /**
      * Constructor
      */
     Smb4KNetworkBrowserDockWidget(const QString &title, QWidget *parent = nullptr);
 
     /**
      * Destructor
      */
     ~Smb4KNetworkBrowserDockWidget();
 
     /**
      * Load settings
      */
     void loadSettings();
 
     /**
      * Save settings
      */
     void saveSettings();
 
     /**
      * Returns the action collection of this dock widget
      * @returns the action collection
      */
     KActionCollection *actionCollection();
 
 protected Q_SLOTS:
     /**
      * This slot is called if the user requests the context menu. It shows
      * the menu with the actions defined for the widget.
      * @param pos                 The position where user clicked.
      */
     void slotContextMenuRequested(const QPoint &pos);
 
     /**
      * This slot is invoked when the user activated an item in the network
      * neighborhood browser.
      * @param item                The item that was executed.
      * @param column              The column where the item was executed.
      */
     void slotItemActivated(QTreeWidgetItem *item, int column);
 
     /**
      * Is called when the selection changed. This slot takes care of the
      * actions being enabled or disabled accordingly. All widget specific
      * stuff has to be done in the browser widget itself.
      * @param item                The selection list view item.
      */
     void slotItemSelectionChanged();
 
     /**
      * This slot is connected to the Smb4KClient::aboutToStart() signal.
      *
      * @param item                The Smb4KBasicNetworkItem object
      * @param process             The process
      */
     void slotClientAboutToStart(const NetworkItemPtr &item, int process);
 
     /**
      * This slot is connected to the Smb4KClient::finished() signal.
      *
      * @param item                The Smb4KBasicNetworkItem object
      * @param process             The process
      */
     void slotClientFinished(const NetworkItemPtr &item, int process);
 
     /**
      * This slot is called when workgroups/domains were discovered
      */
     void slotWorkgroups();
 
     /**
      * This slot is called when the list of servers of workgroup/domain
      * @p workgroup was discovered.
      * @param workgroup           The workgroup/domain that was queried
      */
     void slotWorkgroupMembers(const WorkgroupPtr &workgroup);
 
     /**
      * This slot is called when the list of shared resources of host @p host was
      * queried.
      * @param host                The host that was queried
      */
     void slotShares(const HostPtr &host);
 
     /**
      * Rescan the network or abort a network scan.
      * @param checked             Is TRUE if the action is checked (not used here).
      */
     void slotRescanAbortActionTriggered(bool checked);
 
     /**
      * Bookmark a remote share. This slot is connected to the 'Add Bookmark'
      * action.
      * @param checked             Is TRUE if the action is checked (not used here).
      */
     void slotAddBookmark(bool checked);
 
     /**
      * Manually mount a share. This slot is connected to the 'Mount Manually'
      * action and opens a mount dialog.
      * @param checked             Is TRUE if the action is checked (not used here).
      */
     void slotMountManually(bool checked);
 
     /**
      * Provide authentication for the current network object. This slot is
      * connected to the 'Authentication' action.
      *
      * @param checked             Is TRUE if the action is checked (not used here).
      */
     void slotAuthentication(bool checked);
 
     /**
      * Provide custom options for a server or share. This slot is connected
      * to the 'Add Custom Settings' action.
      *
      * @param checked             Is TRUE if the action is checked (not used here).
      */
     void slotAddCustomSettings(bool checked);
 
     /**
      * Preview a share. This slot is connected to the 'Preview' action.
      * @param checked             Is TRUE if the action is checked (not used here).
      */
     void slotPreview(bool checked);
 
     /**
      * Print a document on a remote printer. This slot is connected to the
      * 'Print File' action.
      * @param checked             Is TRUE if the action is checked (not used here).
      */
     void slotPrint(bool checked);
 
     /**
      * Mount or unmount a share. This slot is connected to the 'Mount'/'Unmount' dual action.
      * @param checked             Is TRUE if the action is checked (not used here).
      */
     void slotMountActionTriggered(bool checked);
 
     /**
      * Change the state of the 'Mount'/'Unmount' dual action.
      * @param active              TRUE if the action is in the active state.
      */
     void slotMountActionChanged(bool active);
 
     /**
      * This slot is called whenever a share has been mounted. It marks the
      * respective share in the tree widget as mounted.
      * @param share               The Smb4KShare object
      */
     void slotShareMounted(const SharePtr &share);
 
     /**
      * This slot is called whenever a share has been unmounted. It marks the
      * respective share in the tree widget as not mounted.
      * @param share               The Smb4KShare object
      */
     void slotShareUnmounted(const SharePtr &share);
 
     /**
      * This slot is connected to the Smb4KMounter::aboutToStart() signal.
      * @param process             The process
      */
     void slotMounterAboutToStart(int process);
 
     /**
      * This slot is connected to the Smb4KMounter::finished() signal.
      * @param process             The process
      */
     void slotMounterFinished(int process);
 
     /**
      * This slot is called when the search toolbar is to be shown
      */
     void slotShowSearchToolBar();
 
     /**
      * This slot is called when the search toolbar is to be closed
      */
     void slotHideSearchToolBar();
 
     /**
      * This slot is called when a search should be performed
      *
      * @param item                The search item
      */
     void slotPerformSearch(const QString &item);
 
     /**
      * This slot is called when a search should be stopped
      */
     void slotStopSearch();
 
     /**
      * This slot is called when a search was performed and the search
      * results were returned
      *
      * @param shares              The list of search results
      */
     void slotSearchResults(const QList<SharePtr> &shares);
 
     /**
      * This slot is called when the user pressed the up or down action
      * in the search toolbar
      *
      * @param url                 The URL of the search result the user wants
      *                            to jump to
      */
     void slotJumpToResult(const QString &url);
 
     /**
      * This slot is called when the search results are to be cleared
      */
     void slotClearSearchResults();
 
 private:
     void setupActions();
     Smb4KNetworkBrowser *m_networkBrowser;
     KActionCollection *m_actionCollection;
     KActionMenu *m_contextMenu;
     Smb4KNetworkSearchToolBar *m_searchToolBar;
     bool m_searchRunning;
 };
 
 #endif