class FXFileDict

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.

Inheritance:

Public Fields

static const FXchar defaultExecBinding[]

Registry key used to find fallback executable icons

static const FXchar defaultDirBinding[]

Registry key used to find fallback directory icons

static const FXchar defaultFileBinding[]

Registry key used to find fallback document icons

Public Methods

FXFileDict(FXApp* a)

Construct a dictionary mapping file-extension to file associations, using the application registry settings as a source for the bindings

FXFileDict(FXApp* a, FXSettings* db)

Construct a dictionary mapping file-extension to file associations, using the specified settings database as a source for the bindings

FXApp* getApp() const

Get application

void setIconPath(const FXString& path)

Set icon search path

FXString getIconPath() const

Return current icon search path

FXFileAssoc* replace(const FXchar* ext, const FXchar* str)

Replace file association.

FXFileAssoc* remove(const FXchar* ext)

Remove file association

FXFileAssoc* find(const FXchar* ext)

Find file association already in dictionary

FXFileAssoc* associate(const FXchar* key)

Find file association from registry

virtual FXFileAssoc* findFileBinding(const FXchar* pathname)

Determine binding for the given file.

virtual FXFileAssoc* findDirBinding(const FXchar* pathname)

Find directory binding from registry.

virtual FXFileAssoc* findExecBinding(const FXchar* pathname)

Determine binding for the given executable.

virtual void save(FXStream& store) const

Save to stream

virtual void load(FXStream& store)

Load from stream

virtual ~FXFileDict()

Destructor

Inherited from FXDict:

Public Methods

FXint size() const

void size(FXint m)

FXint no() const

void* insert(const FXchar* ky, const void* ptr, FXbool mrk=FALSE)

const FXchar* key(FXuint pos) const

void* data(FXuint pos) const

FXbool mark(FXuint pos) const

FXint first() const

FXint last() const

FXint next(FXint pos) const

FXint prev(FXint pos) const

void clear()

Protected Methods

virtual void* createData(const void*)

virtual void deleteData(void*)

Inherited from FXObject:

Public Methods

const FXchar* getClassName() const

FXbool isMemberOf(const FXMetaClass* metaclass) const

Documentation

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.

static const FXchar defaultExecBinding[]

Registry key used to find fallback executable icons

static const FXchar defaultDirBinding[]

Registry key used to find fallback directory icons

static const FXchar defaultFileBinding[]

Registry key used to find fallback document icons

FXFileDict(FXApp* a)

Construct a dictionary mapping file-extension to file associations, using the application registry settings as a source for the bindings

FXFileDict(FXApp* a, FXSettings* db)

Construct a dictionary mapping file-extension to file associations, using the specified settings database as a source for the bindings

FXApp* getApp() const

Get application

void setIconPath(const FXString& path)

Set icon search path

FXString getIconPath() const

Return current icon search path

FXFileAssoc* replace(const FXchar* ext, const FXchar* str)

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* remove(const FXchar* ext)

Remove file association

FXFileAssoc* find(const FXchar* ext)

Find file association already in dictionary

FXFileAssoc* associate(const FXchar* key)

Find file association from registry

virtual FXFileAssoc* findFileBinding(const FXchar* pathname)

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* findDirBinding(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* findExecBinding(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 void save(FXStream& store) const

Save to stream

virtual void load(FXStream& store)

Load from stream

virtual ~FXFileDict()

Destructor

This class has no child classes.

Alphabetic index HTML hierarchy of classes or Java