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
/********************************************************************************
* *
* I c o n D i c t i o n a r y *
* *
*********************************************************************************
* Copyright (C) 1998,2006 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: FXIconDict.h 2344 2006-02-12 21:19:36Z lyle $ *
********************************************************************************/
#ifndef FXICONDICT_H
#define FXICONDICT_H
#ifndef FXDICT_H
#include "FXDict.h"
#endif
namespace FX {
class FXIconSource;
/**
* The Icon Dictionary manages a collection of icons. The icons are referenced
* by their file name. When first encountering a new file name, the icon is
* located by searching the icon search path for the icon file. If found, the
* services of the icon source object are used to load the icon from the file.
* A custom icon source may be installed to furnish support for additonal
* image file formats.
* Once the icon is loaded, an association between the icon name and the icon
* is entered into the icon dictionary. Subsequent searches for an icon with
* this name will be satisfied from the cached value.
* The lifetype of the icons is managed by the icon dictionary, and thus all
* icons will be deleted when the dictionary is deleted.
*/
class FXAPI FXIconDict : public FXDict {
FXDECLARE(FXIconDict)
private:
FXIconSource *source; // Icon source
FXString path; // Where to search icons
protected:
FXIconDict():source(NULL){}
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 icon dictionary, and set initial search path; also
* creates a default icon source object.
*/
FXIconDict(FXApp* app,const FXString& p=defaultIconPath);
/// Change icon source
void setIconSource(FXIconSource *src){ source=src; }
/// Return icon source
FXIconSource* getIconSource() const { return source; }
/// Set icon search path
void setIconPath(const FXString& p){ path=p; }
/// Return current icon search path
const 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);
/// Destroy the icon dict as well as the icon source
virtual ~FXIconDict();
};
}
#endif