FileExplorerTab.h

Go to the documentation of this file.

#pragma once
 
#include "Interfaces/ITab.h"
#include <map>
#include <wx/bmpbuttn.h>
#include <wx/dir.h>
#include <wx/filename.h>
#include <wx/imaglist.h>
#include <wx/scrolwin.h>
#include <wx/splitter.h>
#include <wx/srchctrl.h>
#include <wx/tglbtn.h>
#include <wx/treectrl.h>
#include <wx/wrapsizer.h>
#include <wx/wx.h>

class FileExplorerTab : public ITab {
  public:
    explicit FileExplorerTab(wxWindow *parent);

    virtual ~FileExplorerTab();
 
    // Non-copyable
    FileExplorerTab(const FileExplorerTab &) = delete;
    FileExplorerTab &operator=(const FileExplorerTab &) = delete;
 
    // ITab interface implementation
    wxWindow *GetWidget() override;
    wxString GetTitle() const override;
    wxString GetTabType() const override;
    wxBitmap GetIcon() const override;
 
    void Initialize() override;
    void Refresh() override;
    void OnActivated() override;
    void OnDeactivated() override;
    void OnClosed() override;
 
    bool IsValid() const override;
    bool CanClose() const override;
    bool CanMove() const override;

    wxString GetSelectedFile() const;

    void SetRootDirectory(const wxString &path);
 
  private:
    // Layout creation methods
    void CreateLayout();
    void CreateFavoritesBar(wxBoxSizer *parentSizer);
    void CreateSplitLayout(wxBoxSizer *parentSizer);
    void CreateBreadcrumb(wxPanel *rightPanel, wxBoxSizer *rightSizer);
    void CreateIconGrid(wxPanel *rightPanel, wxBoxSizer *rightSizer);
    void CreateHistoryPanel(wxPanel *rightPanel, wxBoxSizer *rightSizer);
    void PopulateHistoryPanel();
    void ToggleHistoryView();
 
    // Tree methods
    void PopulateTree();
    void AddDirectoryToTree(const wxString &path, wxTreeItemId parentItem);
 
    // Grid methods
    void PopulateGrid(const wxString &path);
    void ClearGrid();
    void AddGridItem(const wxString &name, const wxString &fullPath, bool isDirectory);
 
    // Icon loading (centralized for easy replacement)
    wxBitmap LoadGridIcon(const wxString &iconType, const wxSize &size);
    wxIcon LoadTreeIcon(const wxString &iconType);
 
    // Event handlers - Tree
    void OnSelectionChanged(wxTreeEvent &event);
    void OnItemActivated(wxTreeEvent &event);
    void OnItemExpanding(wxTreeEvent &event);
    void OnBeginDrag(wxTreeEvent &event);
 
    // Event handlers - Grid
    void OnGridItemDoubleClick(wxMouseEvent &event);
    void OnGridItemMouseDown(wxMouseEvent &event);
    void OnGridItemMouseMove(wxMouseEvent &event);
    void OnGridItemMouseUp(wxMouseEvent &event);
 
    // Event handlers - View Toggle
    void OnTreeToggle(wxCommandEvent &event);
    void OnGridToggle(wxCommandEvent &event);
    void UpdateViewVisibility();
    void UpdateToggleButtonAppearance();
 
    // Event handlers - Splitter sync
    void OnSplitterSashPosChanged(wxSplitterEvent &event);
    void OnSplitterSashPosChanging(wxSplitterEvent &event);
    void SyncToolbarWithSplitter();
    void UpdateBreadcrumbVisibility();
    void UpdateHistoryVisibility();
    void UpdateTreeImageList();
 
    // Event handlers - Favorites/Filter
    void OnFavoriteFilter(wxCommandEvent &event);
 
    // Event handlers - Search
    void OnTreeSearchTextChanged(wxCommandEvent &event);
    void OnTreeSearchCancel(wxCommandEvent &event);
    void OnGridSearchTextChanged(wxCommandEvent &event);
    void OnGridSearchCancel(wxCommandEvent &event);
 
    // Event handlers - Breadcrumb
    void OnBreadcrumbClick(wxCommandEvent &event);
 
    // Event handlers - Navigation History
    void OnBackButton(wxCommandEvent &event);
    void OnForwardButton(wxCommandEvent &event);
    void OnHistoryButton(wxCommandEvent &event);
    void OnNavigationKeyDown(wxKeyEvent &event);
 
    // Event handlers - Context Menu
    void OnTreeContextMenu(wxTreeEvent &event);
    void OnGridContextMenu(wxMouseEvent &event);
    void OnGridBackgroundContextMenu(wxMouseEvent &event);
    void OnContextMenuOpen(wxCommandEvent &event);
    void OnContextMenuNewFolder(wxCommandEvent &event);
    void OnContextMenuRename(wxCommandEvent &event);
    void OnContextMenuDelete(wxCommandEvent &event);
    void OnContextMenuCopy(wxCommandEvent &event);
    void OnContextMenuCut(wxCommandEvent &event);
    void OnContextMenuPaste(wxCommandEvent &event);
    void OnContextMenuRefresh(wxCommandEvent &event);
    void OnContextMenuProperties(wxCommandEvent &event);
 
    // Helper methods
    void FilterTree(const wxString &searchText);
    void FilterGrid(const wxString &searchText);
    void ExpandAllMatching(wxTreeItemId item, const wxString &searchText, bool &foundAny);
    bool ItemMatchesSearch(wxTreeItemId item, const wxString &searchText) const;
    bool DirectoryContainsMatchingFiles(const wxString &dirPath) const;
    wxString GetExecutableDirectory() const;
    void NavigateToPath(const wxString &path, bool recordHistory = true);
    void UpdateBreadcrumb();
    bool PassesFilter(const wxString &filename) const;
    bool DirectoryContainsFilteredFiles(const wxString &path) const;
    wxTreeItemId FindTreeItemByPath(const wxString &path, wxTreeItemId parent = wxTreeItemId());
 
    // Navigation history helpers
    void UpdateNavigationButtons();
    void AddToNavigationHistory(const wxString &path);
 
    // Context menu helpers
    bool CreateNewFolder(const wxString &parentPath, const wxString &folderName);
    bool RenameFolder(const wxString &oldPath, const wxString &newName);
    bool DeleteFolder(const wxString &folderPath);
    bool CopyFolder(const wxString &sourcePath, const wxString &destPath);
    bool MoveFolder(const wxString &sourcePath, const wxString &destPath);
    void ShowFolderProperties(const wxString &folderPath);
 
    // File operations
    bool RenameFile(const wxString &oldPath, const wxString &newName);
    bool DeleteFile(const wxString &filePath);
    bool CopyFile(const wxString &sourcePath, const wxString &destPath);
    bool MoveFile(const wxString &sourcePath, const wxString &destPath);
    void ShowFileProperties(const wxString &filePath);
    void OpenFile(const wxString &filePath);
 
    // Utility methods
    wxString GetDirectorySize(const wxString &path) const;
    int CountFilesInDirectory(const wxString &path, bool recursive = true) const;
 
    // UI Components
    wxPanel *m_panel;
    wxSearchCtrl *m_treeSearchCtrl; // Search control for tree grid
    wxSearchCtrl *m_gridSearchCtrl; // Search control for icon grid
    wxTreeCtrl *m_treeCtrl;
    wxSplitterWindow *m_splitter;
    wxPanel *m_leftPanel;  // Left panel containing tree (kept for view toggle)
    wxPanel *m_rightPanel; // Right panel containing grid (kept for view toggle)
    wxScrolledWindow *m_gridCtrl;
    wxWrapSizer *m_gridSizer;
    wxScrolledWindow *m_historyPanel;    // Panel to display navigation history (toggles with grid)
    wxPanel *m_breadcrumbContainerPanel; // Container for navigation, breadcrumb, and functional panels
    wxPanel *m_navigationPanel;          // Panel for search control (left side)
    wxPanel *m_breadcrumbPanel;          // Panel for breadcrumb path (center)
    wxPanel *m_functionalPanel;          // Panel for history and other functional buttons (right side)
    wxBoxSizer *m_breadcrumbSizer;
    wxBoxSizer *m_contentSizer; // Sizer that holds both grid and history panel
 
    // View toggle buttons
    wxToggleButton *m_treeToggleBtn;
    wxToggleButton *m_gridToggleBtn;
 
    // Favorites buttons
    wxToggleButton *m_xmlFilterBtn;
    wxToggleButton *m_pngFilterBtn;
    wxToggleButton *m_jsonFilterBtn;
 
    // Navigation history buttons (in breadcrumb area)
    wxBitmapButton *m_gridBackButton;
    wxBitmapButton *m_gridForwardButton;
    wxBitmapButton *m_historyButton; // Combined history dropdown button
 
    // State
    wxString m_rootPath;
    wxString m_currentGridPath;
    wxString m_activeFilter; // "", ".xml", ".png", ".json"
    bool m_isInitialized;
    bool m_syncInProgress; // Flag to prevent infinite recursion during tree-grid sync
    bool m_treeVisible;    // Whether tree panel is visible
    bool m_gridVisible;    // Whether grid panel is visible
 
    // Navigation history
    std::vector<wxString> m_backStack;    // History of previously visited directories
    std::vector<wxString> m_forwardStack; // Directories we can navigate forward to
    bool m_isNavigatingHistory;           // Flag to prevent adding to history during back/forward navigation
    bool m_isHistoryVisible;              // Flag to track if history panel is currently visible
 
    // Activity history
    enum class ActivityType {
        NAVIGATE,
        OPEN_FILE,
        CREATE_FOLDER,
        DELETE_FILE,
        DELETE_FOLDER,
        RENAME_FILE,
        RENAME_FOLDER,
        COPY,
        CUT,
        PASTE
    };
 
    struct ActivityEntry {
        ActivityType type;
        wxString path;
        wxString details; // Additional info (e.g., old name for rename, destination for paste)
        wxDateTime timestamp;
    };
 
    std::vector<ActivityEntry> m_activityHistory;
    static const size_t MAX_ACTIVITY_ENTRIES = 100;
 
    void LogActivity(ActivityType type, const wxString &path, const wxString &details = "");
 
    // Icons
    wxImageList *m_imageList;
    int m_folderIcon;
    int m_fileIcon;
 
    // Grid icons (large format)
    std::map<wxString, wxBitmap> m_gridIcons;
 
    // Grid item tracking
    struct GridItem {
        wxString name;
        wxString fullPath;
        bool isDirectory;
        wxWindow *widget;
    };
    std::vector<GridItem> m_gridItems;
    wxWindow *m_selectedGridItem;
 
    // Drag and drop state for grid items
    bool m_isDragging;
    wxPoint m_dragStartPos;
    wxWindow *m_dragWindow; // Currently selected grid item panel
 
    // Context menu state
    wxString m_contextMenuPath; // Path of item that was right-clicked
 
    // Clipboard state for copy/cut operations
    wxString m_clipboardPath; // Path of copied/cut folder
    bool m_clipboardIsCut;    // true = cut, false = copy
 
    // Settings from preferences
    bool m_showBreadcrumb;
    bool m_showHistory;
 
    // Tree view settings
    bool m_treeShowHiddenFiles;
    bool m_treeShowFileExtensions;
    int m_treeSortFilesBy; // AppPreferences::SortBy stored as int to avoid header dependency
    int m_treeItemSize;    // Tree item size in pixels (16, 20, or 24)
 
    // Grid view settings
    bool m_gridShowHiddenFiles;
    bool m_gridShowFileExtensions;
    int m_gridSortFilesBy; // AppPreferences::SortBy stored as int to avoid header dependency
    int m_gridIconSize;    // Icon size in pixels (48, 80, or 128)
 
    // Helper to reload settings from preferences
    void LoadSettings();
 
    // Helper to get display name (with or without extension)
    wxString GetDisplayName(const wxString &filename, bool isDirectory, bool isTreeView) const;
 
    // Context menu IDs
    enum ContextMenuID {
        ID_CONTEXT_OPEN = wxID_HIGHEST + 1000,
        ID_CONTEXT_NEW_FOLDER,
        ID_CONTEXT_RENAME,
        ID_CONTEXT_DELETE,
        ID_CONTEXT_COPY,
        ID_CONTEXT_CUT,
        ID_CONTEXT_PASTE,
        ID_CONTEXT_REFRESH,
        ID_CONTEXT_PROPERTIES
    };
};