Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
/********************************************************************************
* *
* F i l e - A s s o c i a t i o n T a b l e *
* *
*********************************************************************************
* Copyright (C) 1998,2005 by Jeroen van der Zijp. All Rights Reserved. *
*********************************************************************************
* This library is free software; you can redistribute it and/or *
* modify it under the terms of the GNU Lesser General Public *
* License as published by the Free Software Foundation; either *
* version 2.1 of the License, or (at your option) any later version. *
* *
* This library is distributed in the hope that it will be useful, *
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
* Lesser General Public License for more details. *
* *
* You should have received a copy of the GNU Lesser General Public *
* License along with this library; if not, write to the Free Software *
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. *
*********************************************************************************
* $Id: FXFileDict.h 2335 2006-01-28 02:33:03Z lyle $ *
********************************************************************************/
#ifndef FXFILEDICT_H
#define FXFILEDICT_H
#ifndef FXDICT_H
#include "FXDict.h"
#endif
namespace FX {
class FXIconDict;
/// Registers stuff to know about the extension
struct FXFileAssoc {
FXString command; /// Command to execute
FXString extension; /// Full extension name
FXString mimetype; /// Mime type name
FXIcon *bigicon; /// Big normal icon
FXIcon *bigiconopen; /// Big open icon
FXIcon *miniicon; /// Mini normal icon
FXIcon *miniiconopen; /// Mini open icon
FXDragType dragtype; /// Registered drag type
FXuint flags; /// Flags; 1=cd, 2=term
};
/**
* The File Association dictionary associates a file extension with a File
* Association record which contains command name, mime type, icons, and other
* information about the file type. The icons referenced by the file association
* are managed by the Icon Dictionary; this guarantees that each icon is loaded
* only once into memory.
* The associations are determined by the information by the FOX Registry settings;
* each entry under the FILETYPES registry section comprises the command line,
* extension name, large icon, small icon, and mime type:
*
* command ';' extension ';' bigicon [ ':' bigiconopen ] ';' icon [ ':' iconopen ] ';' mime [ ';' flags ]
*
* For example, the binding for "jpg" could be:
*
* xv %s &;JPEG Image;bigimage.xpm;miniimage.xpm;image/jpeg;term
*
* The association for a file name is determined by first looking at the entire
* file name, then at the whole extension, and then at sub-extensions.
* For example, "name.tar.gz", "tar.gz", and "gz" can each be given a different
* file association. Directory names may also be given associations; there is
* no command-line association for a directory, however. The association for a
* directory is found by first checking the whole pathname, then checking the
* pathname less the first component, and so on. So, "/usr/local/include",
* "/local/include", and "/include" can each be given their own file associations.
* If the above lookup procedure has not found a file association, the system
* uses a fallback associations: for files, the fallback association is determined
* by the binding "defaultfilebinding". For directories, the "defaultdirbinding"
* is used, and for executables the "defaultexecbinding" is used.
* The flags field is used for a number of bit-flags; two flags are currently
* defined: 'cd' and 'term'. The first one is intended to cause a launcher
* to execute the application in the shown directory; the second one is meant
* to indicate that the application is to be ran inside a new terminal.
*/
class FXAPI FXFileDict : public FXDict {
FXDECLARE(FXFileDict)
private:
FXSettings *settings; // Settings database where to get bindings
FXIconDict *icons; // Icon dictionary which keeps track of loaded icons
protected:
FXFileDict(){}
virtual void *createData(const void*);
virtual void deleteData(void*);
private:
FXFileDict(const FXFileDict&);
FXFileDict &operator=(const FXFileDict&);
public:
/// Registry key used to find fallback executable icons
static const FXchar defaultExecBinding[];
/// Registry key used to find fallback directory icons
static const FXchar defaultDirBinding[];
/// Registry key used to find fallback document icons
static const FXchar defaultFileBinding[];
public:
/**
* Construct a dictionary mapping file-extension to file associations,
* using the application registry settings as a source for the bindings.
* The pointer to the application class is passed down to the icon source
* which is inside the icon dictionary.
*/
FXFileDict(FXApp* app);
/**
* Construct a dictionary mapping file-extension to file associations,
* using the specified settings database as a source for the bindings.
* The pointer to the application class is passed down to the icon source
* which is inside the icon dictionary.
*/
FXFileDict(FXApp* app,FXSettings* db);
/// Change settings database
void setSettings(FXSettings* s){ settings=s; }
/// Return settings database
FXSettings* getSettings() const { return settings; }
/// Change icon dictionary
void setIconDict(FXIconDict *icns){ icons=icns; }
/// Return icon dictionary
FXIconDict* getIconDict() const { return icons; }
/**
* Set icon search path; the initial search path is determined by the
* "iconpath" registry setting in the SETTINGS section.
*/
void setIconPath(const FXString& path);
/// Return current icon search path
const FXString& getIconPath() const;
/**
* Replace file association.
* The new association is written into the settings database under the
* FILETYPES section; the format of the association is as follows:
*
* <extension> = "<command> ; <type> ; <bigicon> [ : <bigopenicon> ] ; <smallicon> [ : <smalliconopen> ] ; <mimetype>"
*
* Where <command> is the command used to launch the application (e.g. "xv %s &"),
* and <type> is the file type string (e.g. "GIF Image"),
* <bigicon> and <bigiconopen> are the large icons shown in "Icons" mode,
* <smallicon> and <smalliconopen> are the small icons shown in "Details" mode,
* and <mimetype> is the RFC2045 mime type of the file.
*
* For example:
*
* [FILETYPES]
* gif="xv %s &;GIF Image;big.xpm:bigopen.xpm;mini.xpm:miniopen.xpm;image/gif"
* /home/jeroen=";Home;home.xpm;minihome.xpm;application/x-folder"
*
*/
FXFileAssoc* replace(const FXchar* ext,const FXchar* str);
/// Remove file association
FXFileAssoc* remove(const FXchar* ext);
/// Find file association from registry
FXFileAssoc* find(const FXchar* ext);
/**
* Determine binding for the given file.
* The default implementation tries the whole filename first,
* then tries the extensions.
* For example, for a file "source.tar.gz":
*
* "source.tar.gz",
* "tar.gz",
* "gz"
*
* are tried in succession. If no association is found the
* key "defaultfilebinding" is tried as a fallback association.
* A NULL is returned if no association of any kind is found.
*/
virtual FXFileAssoc* findFileBinding(const FXchar* pathname);
/**
* Find directory binding from registry.
* The default implementation tries the whole pathname first,
* then tries successively smaller parts of the path.
* For example, a pathname "/usr/people/jeroen":
*
* "/usr/people/jeroen"
* "/people/jeroen"
* "/jeroen"
*
* are tried in succession. If no bindings are found, the
* key "defaultdirbinding" is tried as a fallback association.
* A NULL is returned if no association of any kind is found.
*/
virtual FXFileAssoc* findDirBinding(const FXchar* pathname);
/**
* Determine binding for the given executable.
* The default implementation returns the fallback binding associated with
* the key "defaultexecbinding".
* A NULL is returned if no association of any kind is found.
*/
virtual FXFileAssoc* findExecBinding(const FXchar* pathname);
/// Save to stream
virtual void save(FXStream& store) const;
/// Load from stream
virtual void load(FXStream& store);
/// Destructor
virtual ~FXFileDict();
};
}
#endif