]> git.saurik.com Git - wxWidgets.git/blob - include/wx/generic/filedlgg.h
explained how the signature works
[wxWidgets.git] / include / wx / generic / filedlgg.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: filedlgg.h
3 // Purpose: wxGenericFileDialog
4 // Author: Robert Roebling
5 // Modified by:
6 // Created: 8/17/99
7 // Copyright: (c) Robert Roebling
8 // RCS-ID: $Id$
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
11
12 #ifndef _WX_FILEDLGG_H_
13 #define _WX_FILEDLGG_H_
14
15 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
16 #pragma interface "filedlgg.h"
17 #endif
18
19 #include "wx/listctrl.h"
20 #include "wx/datetime.h"
21
22 //-----------------------------------------------------------------------------
23 // classes
24 //-----------------------------------------------------------------------------
25
26 class WXDLLEXPORT wxBitmapButton;
27 class WXDLLEXPORT wxCheckBox;
28 class WXDLLEXPORT wxChoice;
29 class WXDLLEXPORT wxFileData;
30 class WXDLLEXPORT wxFileCtrl;
31 class WXDLLEXPORT wxGenericFileDialog;
32 class WXDLLEXPORT wxListEvent;
33 class WXDLLEXPORT wxListItem;
34 class WXDLLEXPORT wxStaticText;
35 class WXDLLEXPORT wxTextCtrl;
36
37 #if defined(__WXUNIVERSAL__)||defined(__WXGTK__)||defined(__WXX11__)||defined(__WXMGL__)||defined(__WXCOCOA__)
38 #define USE_GENERIC_FILEDIALOG
39 #endif
40
41 //-------------------------------------------------------------------------
42 // wxGenericFileDialog
43 //-------------------------------------------------------------------------
44
45 class WXDLLEXPORT wxGenericFileDialog: public wxFileDialogBase
46 {
47 public:
48 wxGenericFileDialog() { }
49
50 wxGenericFileDialog(wxWindow *parent,
51 const wxString& message = wxFileSelectorPromptStr,
52 const wxString& defaultDir = wxEmptyString,
53 const wxString& defaultFile = wxEmptyString,
54 const wxString& wildCard = wxFileSelectorDefaultWildcardStr,
55 long style = 0,
56 const wxPoint& pos = wxDefaultPosition);
57 virtual ~wxGenericFileDialog();
58
59 virtual void SetMessage(const wxString& message) { SetTitle(message); }
60 virtual void SetPath(const wxString& path);
61 virtual void SetFilterIndex(int filterIndex);
62
63 // for multiple file selection
64 virtual void GetPaths(wxArrayString& paths) const;
65 virtual void GetFilenames(wxArrayString& files) const;
66
67 // implementation only from now on
68 // -------------------------------
69
70 virtual int ShowModal();
71 virtual bool Show( bool show = true );
72
73 void OnSelected( wxListEvent &event );
74 void OnActivated( wxListEvent &event );
75 void OnList( wxCommandEvent &event );
76 void OnReport( wxCommandEvent &event );
77 void OnUp( wxCommandEvent &event );
78 void OnHome( wxCommandEvent &event );
79 void OnListOk( wxCommandEvent &event );
80 void OnNew( wxCommandEvent &event );
81 void OnChoiceFilter( wxCommandEvent &event );
82 void OnTextEnter( wxCommandEvent &event );
83 void OnTextChange( wxCommandEvent &event );
84 void OnCheck( wxCommandEvent &event );
85
86 virtual void HandleAction( const wxString &fn );
87
88 virtual void UpdateControls();
89
90 protected:
91 // use the filter with the given index
92 void DoSetFilterIndex(int filterindex);
93
94 wxString m_filterExtension;
95 wxChoice *m_choice;
96 wxTextCtrl *m_text;
97 wxFileCtrl *m_list;
98 wxCheckBox *m_check;
99 wxStaticText *m_static;
100 wxBitmapButton *m_upDirButton;
101 wxBitmapButton *m_newDirButton;
102
103 private:
104 DECLARE_DYNAMIC_CLASS(wxGenericFileDialog)
105 DECLARE_EVENT_TABLE()
106
107 // these variables are preserved between wxGenericFileDialog calls
108 static long ms_lastViewStyle; // list or report?
109 static bool ms_lastShowHidden; // did we show hidden files?
110 };
111
112 #ifdef USE_GENERIC_FILEDIALOG
113
114 class WXDLLEXPORT wxFileDialog: public wxGenericFileDialog
115 {
116 DECLARE_DYNAMIC_CLASS(wxFileDialog)
117
118 public:
119 wxFileDialog() {}
120
121 wxFileDialog(wxWindow *parent,
122 const wxString& message = wxFileSelectorPromptStr,
123 const wxString& defaultDir = wxEmptyString,
124 const wxString& defaultFile = wxEmptyString,
125 const wxString& wildCard = wxFileSelectorDefaultWildcardStr,
126 long style = 0,
127 const wxPoint& pos = wxDefaultPosition)
128 :wxGenericFileDialog(parent, message, defaultDir, defaultFile, wildCard, style, pos)
129 {
130 }
131 };
132
133 #endif // USE_GENERIC_FILEDIALOG
134
135 //-----------------------------------------------------------------------------
136 // wxFileData - a class to hold the file info for the wxFileCtrl
137 //-----------------------------------------------------------------------------
138
139 class WXDLLEXPORT wxFileData
140 {
141 public:
142 enum fileType
143 {
144 is_file = 0x0000,
145 is_dir = 0x0001,
146 is_link = 0x0002,
147 is_exe = 0x0004,
148 is_drive = 0x0008
149 };
150
151 // Full copy constructor
152 wxFileData( const wxFileData& fileData ) { Copy(fileData); }
153 // Create a filedata from this information
154 wxFileData( const wxString &filePath, const wxString &fileName,
155 fileType type, int image_id );
156
157 // make a full copy of the other wxFileData
158 void Copy( const wxFileData &other );
159
160 // (re)read the extra data about the file from the system
161 void ReadData();
162
163 // get the name of the file, dir, drive
164 wxString GetFileName() const { return m_fileName; }
165 // get the full path + name of the file, dir, path
166 wxString GetFilePath() const { return m_filePath; }
167 // Set the path + name and name of the item
168 void SetNewName( const wxString &filePath, const wxString &fileName );
169
170 // Get the size of the file in bytes
171 long GetSize() const { return m_size; }
172 // Get the type of file, either file extension or <DIR>, <LINK>, <DRIVE>
173 wxString GetFileType() const;
174 // get the last modification time
175 wxDateTime GetDateTime() const { return m_dateTime; }
176 // Get the time as a formatted string
177 wxString GetModificationTime() const;
178 // in UNIX get rwx for file, in MSW get attributes ARHS
179 wxString GetPermissions() const { return m_permissions; }
180 // Get the id of the image used in a wxImageList
181 int GetImageId() const { return m_image; }
182
183 bool IsFile() const { return !IsDir() && !IsLink() && !IsDrive(); }
184 bool IsDir() const { return (m_type & is_dir ) != 0; }
185 bool IsLink() const { return (m_type & is_link ) != 0; }
186 bool IsExe() const { return (m_type & is_exe ) != 0; }
187 bool IsDrive() const { return (m_type & is_drive) != 0; }
188
189 // Get/Set the type of file, file/dir/drive/link
190 int GetType() const { return m_type; }
191
192 // the wxFileCtrl fields in report view
193 enum fileListFieldType
194 {
195 FileList_Name,
196 FileList_Size,
197 FileList_Type,
198 FileList_Time,
199 #if defined(__UNIX__) || defined(__WIN32__)
200 FileList_Perm,
201 #endif // defined(__UNIX__) || defined(__WIN32__)
202 FileList_Max
203 };
204
205 // Get the entry for report view of wxFileCtrl
206 wxString GetEntry( fileListFieldType num ) const;
207
208 // Get a string representation of the file info
209 wxString GetHint() const;
210 // initialize a wxListItem attributes
211 void MakeItem( wxListItem &item );
212
213
214 wxFileData& operator = (const wxFileData& fd) { Copy(fd); return *this; }
215
216 private:
217 wxString m_fileName;
218 wxString m_filePath;
219 long m_size;
220 wxDateTime m_dateTime;
221 wxString m_permissions;
222 int m_type;
223 int m_image;
224 };
225
226 //-----------------------------------------------------------------------------
227 // wxFileCtrl
228 //-----------------------------------------------------------------------------
229
230 class WXDLLEXPORT wxFileCtrl : public wxListCtrl
231 {
232 public:
233 wxFileCtrl();
234 wxFileCtrl( wxWindow *win,
235 wxWindowID id,
236 const wxString &wild,
237 bool showHidden,
238 const wxPoint &pos = wxDefaultPosition,
239 const wxSize &size = wxDefaultSize,
240 long style = wxLC_LIST,
241 const wxValidator &validator = wxDefaultValidator,
242 const wxString &name = wxT("filelist") );
243 virtual ~wxFileCtrl();
244
245 virtual void ChangeToListMode();
246 virtual void ChangeToReportMode();
247 virtual void ChangeToSmallIconMode();
248 virtual void ShowHidden( bool show = true );
249 bool GetShowHidden() const { return m_showHidden; }
250
251 virtual long Add( wxFileData *fd, wxListItem &item );
252 virtual void UpdateItem(const wxListItem &item);
253 virtual void UpdateFiles();
254 virtual void MakeDir();
255 virtual void GoToParentDir();
256 virtual void GoToHomeDir();
257 virtual void GoToDir( const wxString &dir );
258 virtual void SetWild( const wxString &wild );
259 wxString GetWild() const { return m_wild; }
260 wxString GetDir() const { return m_dirName; }
261
262 void OnListDeleteItem( wxListEvent &event );
263 void OnListDeleteAllItems( wxListEvent &event );
264 void OnListEndLabelEdit( wxListEvent &event );
265 void OnListColClick( wxListEvent &event );
266
267 virtual void SortItems(wxFileData::fileListFieldType field, bool foward);
268 bool GetSortDirection() const { return m_sort_foward; }
269 wxFileData::fileListFieldType GetSortField() const { return m_sort_field; }
270
271 protected:
272 void FreeItemData(wxListItem& item);
273 void FreeAllItemsData();
274
275 wxString m_dirName;
276 bool m_showHidden;
277 wxString m_wild;
278
279 bool m_sort_foward;
280 wxFileData::fileListFieldType m_sort_field;
281
282 private:
283 DECLARE_DYNAMIC_CLASS(wxFileCtrl);
284 DECLARE_EVENT_TABLE()
285 };
286
287 #endif // _WX_FILEDLGG_H_
288