/////////////////////////////////////////////////////////////////////////////
-// Name: dirctrlg.h
+// Name: wx/generic/dirctrlg.h
// Purpose: wxGenericDirCtrl class
// Builds on wxDirCtrl class written by Robert Roebling for the
// wxFile application, modified by Harm van der Heijden.
// Further modified for Windows.
-// Author: Julian Smart et al
+// Author: Robert Roebling, Harm van der Heijden, Julian Smart et al
// Modified by:
// Created: 21/3/2000
// RCS-ID: $Id$
-// Copyright: (c) Julian Smart
+// Copyright: (c) Robert Roebling, Harm van der Heijden, Julian Smart
// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
#ifndef _WX_DIRCTRL_H_
#define _WX_DIRCTRL_H_
-#ifdef __GNUG__
-#pragma interface "dirctrlg.h"
-#endif
-
#if wxUSE_DIRDLG
#include "wx/treectrl.h"
+#include "wx/dialog.h"
#include "wx/dirdlg.h"
#include "wx/choice.h"
// classes
//-----------------------------------------------------------------------------
+class WXDLLIMPEXP_FWD_CORE wxTextCtrl;
+class WXDLLIMPEXP_FWD_BASE wxHashTable;
+
//-----------------------------------------------------------------------------
// Extra styles for wxGenericDirCtrl
//-----------------------------------------------------------------------------
-// Only allow directory viewing/selection, no files
-#define wxDIRCTRL_DIR_ONLY 0x0010
-// When setting the default path, select the first file in the directory
-#define wxDIRCTRL_SELECT_FIRST 0x0020
-// Show the filter list
-#define wxDIRCTRL_SHOW_FILTERS 0x0040
-// Use 3D borders on internal controls
-#define wxDIRCTRL_3D_INTERNAL 0x0080
+enum
+{
+ // Only allow directory viewing/selection, no files
+ wxDIRCTRL_DIR_ONLY = 0x0010,
+ // When setting the default path, select the first file in the directory
+ wxDIRCTRL_SELECT_FIRST = 0x0020,
+#if WXWIN_COMPATIBILITY_2_8
+ // Unused, for compatibility only
+ wxDIRCTRL_SHOW_FILTERS = 0x0040,
+#endif // WXWIN_COMPATIBILITY_2_8
+ // Use 3D borders on internal controls
+ wxDIRCTRL_3D_INTERNAL = 0x0080,
+ // Editable labels
+ wxDIRCTRL_EDIT_LABELS = 0x0100,
+ // Allow multiple selection
+ wxDIRCTRL_MULTIPLE = 0x0200
+};
//-----------------------------------------------------------------------------
// wxDirItemData
//-----------------------------------------------------------------------------
-class WXDLLEXPORT wxDirItemDataEx : public wxTreeItemData
+class WXDLLIMPEXP_CORE wxDirItemData : public wxTreeItemData
{
public:
- wxDirItemDataEx(const wxString& path, const wxString& name, bool isDir);
- ~wxDirItemDataEx();
- void SetNewDirName( wxString path );
- wxString m_path, m_name;
- bool m_isHidden;
- bool m_hasSubDirs;
- bool m_isExpanded;
- bool m_isDir;
+ wxDirItemData(const wxString& path, const wxString& name, bool isDir);
+ virtual ~wxDirItemData(){}
+ void SetNewDirName(const wxString& path);
+
+ bool HasSubDirs() const;
+ bool HasFiles(const wxString& spec = wxEmptyString) const;
+
+ wxString m_path, m_name;
+ bool m_isHidden;
+ bool m_isExpanded;
+ bool m_isDir;
};
//-----------------------------------------------------------------------------
// wxDirCtrl
//-----------------------------------------------------------------------------
-class WXDLLEXPORT wxDirFilterListCtrl;
+class WXDLLIMPEXP_FWD_CORE wxDirFilterListCtrl;
-class WXDLLEXPORT wxGenericDirCtrl: public wxControl
+class WXDLLIMPEXP_CORE wxGenericDirCtrl: public wxControl
{
public:
wxGenericDirCtrl();
- wxGenericDirCtrl(wxWindow *parent, const wxWindowID id = -1,
+ wxGenericDirCtrl(wxWindow *parent, const wxWindowID id = wxID_ANY,
const wxString &dir = wxDirDialogDefaultFolderStr,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
- long style = wxDIRCTRL_3D_INTERNAL|wxSUNKEN_BORDER,
+ long style = wxDIRCTRL_3D_INTERNAL,
const wxString& filter = wxEmptyString,
int defaultFilter = 0,
const wxString& name = wxTreeCtrlNameStr )
Init();
Create(parent, id, dir, pos, size, style, filter, defaultFilter, name);
}
-
- bool Create(wxWindow *parent, const wxWindowID id = -1,
+
+ bool Create(wxWindow *parent, const wxWindowID id = wxID_ANY,
const wxString &dir = wxDirDialogDefaultFolderStr,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
- long style = wxDIRCTRL_3D_INTERNAL|wxSUNKEN_BORDER,
+ long style = wxDIRCTRL_3D_INTERNAL,
const wxString& filter = wxEmptyString,
int defaultFilter = 0,
const wxString& name = wxTreeCtrlNameStr );
- void Init();
+ virtual void Init();
- ~wxGenericDirCtrl();
+ virtual ~wxGenericDirCtrl();
void OnExpandItem(wxTreeEvent &event );
void OnCollapseItem(wxTreeEvent &event );
void OnSize(wxSizeEvent &event );
// Try to expand as much of the given path as possible.
- bool ExpandPath(const wxString& path);
+ virtual bool ExpandPath(const wxString& path);
+ // collapse the path
+ virtual bool CollapsePath(const wxString& path);
// Accessors
- inline wxString GetDefaultPath() const { return m_defaultPath; }
- void SetDefaultPath(const wxString& path) { m_defaultPath = path; }
+ virtual inline wxString GetDefaultPath() const { return m_defaultPath; }
+ virtual void SetDefaultPath(const wxString& path) { m_defaultPath = path; }
// Get dir or filename
- wxString GetPath() const ;
+ virtual wxString GetPath() const;
+ virtual void GetPaths(wxArrayString& paths) const;
+
// Get selected filename path only (else empty string).
// I.e. don't count a directory as a selection
- wxString GetFilePath() const ;
- void SetPath(const wxString& path) ;
+ virtual wxString GetFilePath() const;
+ virtual void GetFilePaths(wxArrayString& paths) const;
+ virtual void SetPath(const wxString& path);
+
+ virtual void SelectPath(const wxString& path, bool select = true);
+ virtual void SelectPaths(const wxArrayString& paths);
+
+ virtual void ShowHidden( bool show );
+ virtual bool GetShowHidden() { return m_showHidden; }
+
+ virtual wxString GetFilter() const { return m_filter; }
+ virtual void SetFilter(const wxString& filter);
- wxString GetFilter() const { return m_filter; }
- void SetFilter(const wxString& filter);
+ virtual int GetFilterIndex() const { return m_currentFilter; }
+ virtual void SetFilterIndex(int n);
- int GetFilterIndex() const { return m_currentFilter; }
- void SetFilterIndex(int n) ;
+ virtual wxTreeItemId GetRootId() { return m_rootId; }
- wxTreeItemId GetRootId() { return m_rootId; }
+ virtual wxTreeCtrl* GetTreeCtrl() const { return m_treeCtrl; }
+ virtual wxDirFilterListCtrl* GetFilterListCtrl() const { return m_filterListCtrl; }
- wxTreeCtrl* GetTreeCtrl() const { return m_treeCtrl; }
- wxDirFilterListCtrl* GetFilterListCtrl() const { return m_filterListCtrl; }
+ virtual void UnselectAll();
+
+ // Helper
+ virtual void SetupSections();
-//// Helpers
- void SetupSections();
- // Parse the filter into an array of filters and an array of descriptions
- int ParseFilter(const wxString& filterStr, wxArrayString& filters, wxArrayString& descriptions);
// Find the child that matches the first part of 'path'.
// E.g. if a child path is "/usr" and 'path' is "/usr/include"
// then the child for /usr is returned.
- // If the path string has been used (we're at the leaf), done is set to TRUE
- wxTreeItemId FindChild(wxTreeItemId parentId, const wxString& path, bool& done);
-
+ // If the path string has been used (we're at the leaf), done is set to true
+ virtual wxTreeItemId FindChild(wxTreeItemId parentId, const wxString& path, bool& done);
+
// Resize the components of the control
- void DoResize();
+ virtual void DoResize();
+
+ // Collapse & expand the tree, thus re-creating it from scratch:
+ virtual void ReCreateTree();
+
+ // Collapse the entire tree
+ virtual void CollapseTree();
+
+ // overridden base class methods
+ virtual void SetFocus();
+
protected:
- void ExpandDir(wxTreeItemId parentId);
- void AddSection(const wxString& path, const wxString& name, int imageId = 0);
+ virtual void ExpandRoot();
+ virtual void ExpandDir(wxTreeItemId parentId);
+ virtual void CollapseDir(wxTreeItemId parentId);
+ virtual const wxTreeItemId AddSection(const wxString& path, const wxString& name, int imageId = 0);
+ virtual wxTreeItemId AppendItem (const wxTreeItemId & parent,
+ const wxString & text,
+ int image = -1, int selectedImage = -1,
+ wxTreeItemData * data = NULL);
//void FindChildFiles(wxTreeItemId id, int dirFlags, wxArrayString& filenames);
+ virtual wxTreeCtrl* CreateTreeCtrl(wxWindow *parent, wxWindowID id, const wxPoint& pos, const wxSize& size, long treeStyle);
// Extract description and actual filter from overall filter string
bool ExtractWildcard(const wxString& filterStr, int n, wxString& filter, wxString& description);
private:
+ void PopulateNode(wxTreeItemId node);
+
bool m_showHidden;
wxTreeItemId m_rootId;
- wxImageList* m_imageList;
wxString m_defaultPath; // Starting path
long m_styleEx; // Extended style
wxString m_filter; // Wildcards in same format as per wxFileDialog
private:
DECLARE_EVENT_TABLE()
DECLARE_DYNAMIC_CLASS(wxGenericDirCtrl)
+ wxDECLARE_NO_COPY_CLASS(wxGenericDirCtrl);
};
//-----------------------------------------------------------------------------
// wxDirFilterListCtrl
//-----------------------------------------------------------------------------
-class WXDLLEXPORT wxDirFilterListCtrl: public wxChoice
+class WXDLLIMPEXP_CORE wxDirFilterListCtrl: public wxChoice
{
public:
wxDirFilterListCtrl() { Init(); }
- wxDirFilterListCtrl(wxGenericDirCtrl* parent, const wxWindowID id = -1,
+ wxDirFilterListCtrl(wxGenericDirCtrl* parent, const wxWindowID id = wxID_ANY,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = 0)
Init();
Create(parent, id, pos, size, style);
}
-
- bool Create(wxGenericDirCtrl* parent, const wxWindowID id = -1,
+
+ bool Create(wxGenericDirCtrl* parent, const wxWindowID id = wxID_ANY,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = 0);
void Init();
- ~wxDirFilterListCtrl() {};
+ virtual ~wxDirFilterListCtrl() {}
-//// Operations
+ //// Operations
void FillFilterList(const wxString& filter, int defaultFilter);
-//// Events
+ //// Events
void OnSelFilter(wxCommandEvent& event);
protected:
DECLARE_EVENT_TABLE()
DECLARE_CLASS(wxDirFilterListCtrl)
+ wxDECLARE_NO_COPY_CLASS(wxDirFilterListCtrl);
};
+#if !defined(__WXMSW__) && !defined(__WXMAC__) && !defined(__WXPM__)
+ #define wxDirCtrl wxGenericDirCtrl
+#endif
+
+// Symbols for accessing individual controls
#define wxID_TREECTRL 7000
#define wxID_FILTERLISTCTRL 7001
-//-----------------------------------------------------------------------------
-// wxGenericDirDialog
-//
-//-----------------------------------------------------------------------------
-
-class wxGenericDirDialog: public wxDialog
-{
-DECLARE_EVENT_TABLE()
-public:
- wxGenericDirDialog(): wxDialog() {}
- wxGenericDirDialog(wxWindow* parent, const wxString& title,
- const wxString& defaultPath = wxEmptyString, long style = wxDEFAULT_DIALOG_STYLE, const wxPoint& pos = wxDefaultPosition, const wxSize& sz = wxSize(450, 550), const wxString& name = "dialog");
+#endif // wxUSE_DIRDLG
-//// Event handlers
- void OnCloseWindow(wxCloseEvent& event);
- void OnOK(wxCommandEvent& event);
- void OnTreeSelected( wxTreeEvent &event );
- void OnTreeKeyDown( wxTreeEvent &event );
- void OnNew(wxCommandEvent& event);
+//-------------------------------------------------------------------------
+// wxFileIconsTable - use wxTheFileIconsTable which is created as necessary
+//-------------------------------------------------------------------------
-//// Accessors
- inline void SetMessage(const wxString& message) { m_message = message; }
- void SetPath(const wxString& path) ;
- inline void SetStyle(long style) { m_dialogStyle = style; }
+#if wxUSE_DIRDLG || wxUSE_FILEDLG || wxUSE_FILECTRL
- inline wxString GetMessage(void) const { return m_message; }
- wxString GetPath(void) const ;
- inline long GetStyle(void) const { return m_dialogStyle; }
+class WXDLLIMPEXP_FWD_CORE wxImageList;
- wxTextCtrl* GetInputCtrl() const { return m_input; }
+class WXDLLIMPEXP_CORE wxFileIconsTable
+{
+public:
+ wxFileIconsTable();
+ ~wxFileIconsTable();
-//// Overrides
- int ShowModal();
+ enum iconId_Type
+ {
+ folder,
+ folder_open,
+ computer,
+ drive,
+ cdrom,
+ floppy,
+ removeable,
+ file,
+ executable
+ };
+
+ int GetIconID(const wxString& extension, const wxString& mime = wxEmptyString);
+ wxImageList *GetSmallImageList();
protected:
- wxString m_message;
- long m_dialogStyle;
- wxString m_path;
- wxGenericDirCtrl* m_dirCtrl;
- wxTextCtrl* m_input;
+ void Create(); // create on first use
+ wxImageList *m_smallImageList;
+ wxHashTable *m_HashTable;
};
-#endif // wxUSE_DIRDLG
+// The global fileicons table
+extern WXDLLIMPEXP_DATA_CORE(wxFileIconsTable *) wxTheFileIconsTable;
+
+#endif // wxUSE_DIRDLG || wxUSE_FILEDLG || wxUSE_FILECTRL
#endif
// _WX_DIRCTRLG_H_