include/wx/generic/dirctrlg.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        dirctrlg.h
   3 // Purpose:     wxGenericDirCtrl class
   4 //              Builds on wxDirCtrl class written by Robert Roebling for the
   5 //              wxFile application, modified by Harm van der Heijden.
   6 //              Further modified for Windows.
   7 // Author:      Robert Roebling, Harm van der Heijden, Julian Smart et al
   8 // Modified by:
   9 // Created:     21/3/2000
  10 // RCS-ID:      $Id$
  11 // Copyright:   (c) Robert Roebling, Harm van der Heijden, Julian Smart
  12 // Licence:     wxWindows licence
  13 /////////////////////////////////////////////////////////////////////////////
  14
  15 #ifndef _WX_DIRCTRL_H_
  16 #define _WX_DIRCTRL_H_
  17
  18 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
  19 #pragma interface "dirctrlg.h"
  20 #endif
  21
  22 #if wxUSE_DIRDLG
  23
  24 #include "wx/treectrl.h"
  25 #include "wx/dialog.h"
  26 #include "wx/dirdlg.h"
  27 #include "wx/choice.h"
  28
  29 //-----------------------------------------------------------------------------
  30 // classes
  31 //-----------------------------------------------------------------------------
  32
  33 class WXDLLEXPORT wxTextCtrl;
  34 class WXDLLEXPORT wxImageList;
  35 class WXDLLEXPORT wxHashTable;
  36
  37 //-----------------------------------------------------------------------------
  38 // Extra styles for wxGenericDirCtrl
  39 //-----------------------------------------------------------------------------
  40
  41 enum
  42 {
  43     // Only allow directory viewing/selection, no files
  44     wxDIRCTRL_DIR_ONLY       = 0x0010,
  45     // When setting the default path, select the first file in the directory
  46     wxDIRCTRL_SELECT_FIRST   = 0x0020,
  47     // Show the filter list
  48     wxDIRCTRL_SHOW_FILTERS   = 0x0040,
  49     // Use 3D borders on internal controls
  50     wxDIRCTRL_3D_INTERNAL    = 0x0080,
  51     // Editable labels
  52     wxDIRCTRL_EDIT_LABELS    = 0x0100
  53 };
  54
  55 //-----------------------------------------------------------------------------
  56 // wxDirItemData
  57 //-----------------------------------------------------------------------------
  58
  59 class WXDLLEXPORT wxDirItemData : public wxTreeItemData
  60 {
  61 public:
  62     wxDirItemData(const wxString& path, const wxString& name, bool isDir);
  63     ~wxDirItemData();
  64     void SetNewDirName(const wxString& path);
  65
  66     bool HasSubDirs() const;
  67     bool HasFiles(const wxString& spec = wxEmptyString) const;
  68
  69     wxString m_path, m_name;
  70     bool m_isHidden;
  71     bool m_isExpanded;
  72     bool m_isDir;
  73 };
  74
  75 //-----------------------------------------------------------------------------
  76 // wxDirCtrl
  77 //-----------------------------------------------------------------------------
  78
  79 class WXDLLEXPORT wxDirFilterListCtrl;
  80
  81 class WXDLLEXPORT wxGenericDirCtrl: public wxControl
  82 {
  83 public:
  84     wxGenericDirCtrl();
  85     wxGenericDirCtrl(wxWindow *parent, const wxWindowID id = -1,
  86               const wxString &dir = wxDirDialogDefaultFolderStr,
  87               const wxPoint& pos = wxDefaultPosition,
  88               const wxSize& size = wxDefaultSize,
  89               long style = wxDIRCTRL_3D_INTERNAL|wxSUNKEN_BORDER,
  90               const wxString& filter = wxEmptyString,
  91               int defaultFilter = 0,
  92               const wxString& name = wxTreeCtrlNameStr )
  93     {
  94         Init();
  95         Create(parent, id, dir, pos, size, style, filter, defaultFilter, name);
  96     }
  97
  98     bool Create(wxWindow *parent, const wxWindowID id = -1,
  99               const wxString &dir = wxDirDialogDefaultFolderStr,
 100               const wxPoint& pos = wxDefaultPosition,
 101               const wxSize& size = wxDefaultSize,
 102               long style = wxDIRCTRL_3D_INTERNAL|wxSUNKEN_BORDER,
 103               const wxString& filter = wxEmptyString,
 104               int defaultFilter = 0,
 105               const wxString& name = wxTreeCtrlNameStr );
 106
 107     virtual void Init();
 108
 109     virtual ~wxGenericDirCtrl();
 110
 111     void OnExpandItem(wxTreeEvent &event );
 112     void OnCollapseItem(wxTreeEvent &event );
 113     void OnBeginEditItem(wxTreeEvent &event );
 114     void OnEndEditItem(wxTreeEvent &event );
 115     void OnSize(wxSizeEvent &event );
 116
 117     // Try to expand as much of the given path as possible.
 118     virtual bool ExpandPath(const wxString& path);
 119
 120     // Accessors
 121
 122     virtual inline wxString GetDefaultPath() const { return m_defaultPath; }
 123     virtual void SetDefaultPath(const wxString& path) { m_defaultPath = path; }
 124
 125     // Get dir or filename
 126     virtual wxString GetPath() const;
 127
 128     // Get selected filename path only (else empty string).
 129     // I.e. don't count a directory as a selection
 130     virtual wxString GetFilePath() const;
 131     virtual void SetPath(const wxString& path);
 132
 133     virtual void ShowHidden( bool show );
 134     virtual bool GetShowHidden() { return m_showHidden; }
 135
 136     virtual wxString GetFilter() const { return m_filter; }
 137     virtual void SetFilter(const wxString& filter);
 138
 139     virtual int GetFilterIndex() const { return m_currentFilter; }
 140     virtual void SetFilterIndex(int n);
 141
 142     virtual wxTreeItemId GetRootId() { return m_rootId; }
 143
 144     virtual wxTreeCtrl* GetTreeCtrl() const { return m_treeCtrl; }
 145     virtual wxDirFilterListCtrl* GetFilterListCtrl() const { return m_filterListCtrl; }
 146
 147     // Helper
 148     virtual void SetupSections();
 149
 150 #if WXWIN_COMPATIBILITY_2_4
 151     // Parse the filter into an array of filters and an array of descriptions
 152     virtual int ParseFilter(const wxString& filterStr, wxArrayString& filters, wxArrayString& descriptions);
 153 #endif // WXWIN_COMPATIBILITY_2_4
 154
 155     // Find the child that matches the first part of 'path'.
 156     // E.g. if a child path is "/usr" and 'path' is "/usr/include"
 157     // then the child for /usr is returned.
 158     // If the path string has been used (we're at the leaf), done is set to TRUE
 159     virtual wxTreeItemId FindChild(wxTreeItemId parentId, const wxString& path, bool& done);
 160
 161     // Resize the components of the control
 162     virtual void DoResize();
 163
 164     // Collapse & expand the tree, thus re-creating it from scratch:
 165     virtual void ReCreateTree();
 166
 167 protected:
 168     virtual void ExpandDir(wxTreeItemId parentId);
 169     virtual void CollapseDir(wxTreeItemId parentId);
 170     virtual const wxTreeItemId AddSection(const wxString& path, const wxString& name, int imageId = 0);
 171     virtual wxTreeItemId AppendItem (const wxTreeItemId & parent,
 172                 const wxString & text,
 173                 int image = -1, int selectedImage = -1,
 174                 wxTreeItemData * data = NULL);
 175     //void FindChildFiles(wxTreeItemId id, int dirFlags, wxArrayString& filenames);
 176
 177     // Extract description and actual filter from overall filter string
 178     bool ExtractWildcard(const wxString& filterStr, int n, wxString& filter, wxString& description);
 179
 180 private:
 181     bool            m_showHidden;
 182     wxTreeItemId    m_rootId;
 183     wxString        m_defaultPath; // Starting path
 184     long            m_styleEx; // Extended style
 185     wxString        m_filter;  // Wildcards in same format as per wxFileDialog
 186     int             m_currentFilter; // The current filter index
 187     wxString        m_currentFilterStr; // Current filter string
 188     wxTreeCtrl*     m_treeCtrl;
 189     wxDirFilterListCtrl* m_filterListCtrl;
 190
 191 private:
 192     DECLARE_EVENT_TABLE()
 193     DECLARE_DYNAMIC_CLASS(wxGenericDirCtrl)
 194     DECLARE_NO_COPY_CLASS(wxGenericDirCtrl)
 195 };
 196
 197 //-----------------------------------------------------------------------------
 198 // wxDirFilterListCtrl
 199 //-----------------------------------------------------------------------------
 200
 201 class WXDLLEXPORT wxDirFilterListCtrl: public wxChoice
 202 {
 203 public:
 204     wxDirFilterListCtrl() { Init(); }
 205     wxDirFilterListCtrl(wxGenericDirCtrl* parent, const wxWindowID id = -1,
 206               const wxPoint& pos = wxDefaultPosition,
 207               const wxSize& size = wxDefaultSize,
 208               long style = 0)
 209     {
 210         Init();
 211         Create(parent, id, pos, size, style);
 212     }
 213
 214     bool Create(wxGenericDirCtrl* parent, const wxWindowID id = -1,
 215               const wxPoint& pos = wxDefaultPosition,
 216               const wxSize& size = wxDefaultSize,
 217               long style = 0);
 218
 219     void Init();
 220
 221     ~wxDirFilterListCtrl() {};
 222
 223     //// Operations
 224     void FillFilterList(const wxString& filter, int defaultFilter);
 225
 226     //// Events
 227     void OnSelFilter(wxCommandEvent& event);
 228
 229 protected:
 230     wxGenericDirCtrl*    m_dirCtrl;
 231
 232     DECLARE_EVENT_TABLE()
 233     DECLARE_CLASS(wxDirFilterListCtrl)
 234     DECLARE_NO_COPY_CLASS(wxDirFilterListCtrl)
 235 };
 236
 237 #if !defined(__WXMSW__) && !defined(__WXMAC__) && !defined(__WXPM__)
 238     #define wxDirCtrl wxGenericDirCtrl
 239 #endif
 240
 241 // Symbols for accessing individual controls
 242 #define wxID_TREECTRL          7000
 243 #define wxID_FILTERLISTCTRL    7001
 244
 245 //-------------------------------------------------------------------------
 246 // wxFileIconsTable - use wxTheFileIconsTable which is created as necessary
 247 //-------------------------------------------------------------------------
 248
 249 class WXDLLEXPORT wxFileIconsTable
 250 {
 251 public:
 252     wxFileIconsTable();
 253     ~wxFileIconsTable();
 254
 255     enum iconId_Type
 256     {
 257         folder,
 258         folder_open,
 259         computer,
 260         drive,
 261         cdrom,
 262         floppy,
 263         removeable,
 264         file,
 265         executable
 266     };
 267
 268     int GetIconID(const wxString& extension, const wxString& mime = wxEmptyString);
 269     wxImageList *GetSmallImageList();
 270
 271 protected:
 272     void Create();  // create on first use
 273
 274     wxImageList *m_smallImageList;
 275     wxHashTable *m_HashTable;
 276 };
 277
 278 // The global fileicons table
 279 WXDLLEXPORT_DATA(extern wxFileIconsTable *) wxTheFileIconsTable;
 280
 281 #endif // wxUSE_DIRDLG
 282
 283 #endif
 284     // _WX_DIRCTRLG_H_