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 228 229 230 231 232 233 234
|
/********************************************************************************
* *
* F i l e - A s s o c i a t i o n T a b l e *
* *
*********************************************************************************
* Copyright (C) 1998,2002 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,v 1.17 2002/01/23 18:53:57 jeroen Exp $ *
********************************************************************************/
#ifndef FXFILEDICT_H
#define FXFILEDICT_H
#ifndef FXDICT_H
#include "FXDict.h"
#endif
/// 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
};
/// Icon dictionary
class FXAPI FXIconDict : public FXDict {
FXDECLARE(FXIconDict)
private:
FXApp *app; // Application object
FXString path; // Where to search icons
protected:
FXIconDict(){}
virtual void *createData(const void*);
virtual void deleteData(void*);
private:
FXIconDict(const FXIconDict&);
FXIconDict &operator=(const FXIconDict&);
public:
/// Default icon search path
static const FXchar defaultIconPath[];
public:
/// Construct an icon dictionary, with given path
FXIconDict(FXApp* a,const FXString& p=defaultIconPath);
/// Get application
FXApp* getApp() const { return app; }
/// Set icon search path
void setIconPath(const FXString& p){ path=p; }
/// Return current icon search path
FXString getIconPath() const { return path; }
/// Insert unique icon loaded from filename into dictionary
FXIcon* insert(const FXchar* name){ return (FXIcon*)FXDict::insert(name,name); }
/// Remove icon from dictionary
FXIcon* remove(const FXchar* name){ return (FXIcon*)FXDict::remove(name); }
/// Find icon by name
FXIcon* find(const FXchar* name){ return (FXIcon*)FXDict::find(name); }
/// Save to stream
virtual void save(FXStream& store) const;
/// Load from stream
virtual void load(FXStream& store);
/// Destructor
virtual ~FXIconDict();
};
/**
* The File Association dictionary associates a file extension
* with a FXFileAssoc record which contains command name, mime type,
* icons, and other information about the file type.
* The Registry is used as source of the file bindings; an alternative
* Settings database may be specified however.
*/
class FXAPI FXFileDict : public FXDict {
FXDECLARE(FXFileDict)
private:
FXApp *app; // Application object
FXSettings *settings; // Settings database where to get bindings
FXIconDict *icons; // Icon table
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.
*/
FXFileDict(FXApp* a);
/**
* Construct a dictionary mapping file-extension to file associations,
* using the specified settings database as a source for the bindings.
*/
FXFileDict(FXApp* a,FXSettings* db);
/// Get application
FXApp* getApp() const { return app; }
/// Set icon search path
void setIconPath(const FXString& path);
/// Return current icon search path
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 already in dictionary
FXFileAssoc* find(const FXchar* ext){ return (FXFileAssoc*)FXDict::find(ext); }
/// Find file association from registry
FXFileAssoc* associate(const FXchar* key);
/**
* 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
|