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
|
/********************************************************************************
* *
* R e c e n t F i l e s L i s t *
* *
*********************************************************************************
* Copyright (C) 1998,2022 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 3 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 program. If not, see <http://www.gnu.org/licenses/> *
********************************************************************************/
#ifndef FXRECENTFILES_H
#define FXRECENTFILES_H
#ifndef FXOBJECT_H
#include "FXObject.h"
#endif
namespace FX {
class FXApp;
/**
* The Recent Files group manages a most recently used (MRU) file list by
* means of the standard system registry.
* When connected to a widget, like a menu command, the recent files object
* updates the menu commands label to the associated recent file name; when
* the menu command is invoked, the recent file object sends its target a
* SEL_COMMAND message with the message data set to the associated file name,
* of the type const char*.
* When adding or removing file names, the recent files object automatically
* updates the system registry to record these changes.
* The ID_ANYFILES may be connected to a menu separator to cause automatic
* hiding of the menu separator when there are no recent files.
* The number of file names is typically no more than 10.
* File names should not be empty.
*/
class FXAPI FXRecentFiles : public FXObject {
FXDECLARE(FXRecentFiles)
private:
FXSettings *settings; // Settings database where list is kept
FXObject *target; // Target object to send message
FXSelector message; // Message to send
FXString group; // MRU File group
FXuint maxfiles; // Maximum number of files to track
private:
static const FXchar key[32][7];
private:
FXRecentFiles(const FXRecentFiles&);
FXRecentFiles &operator=(const FXRecentFiles&);
public:
long onCmdClear(FXObject*,FXSelector,void*);
long onCmdFile(FXObject*,FXSelector,void*);
long onUpdFile(FXObject*,FXSelector,void*);
long onUpdAnyFiles(FXObject*,FXSelector,void*);
public:
enum{
ID_CLEAR,
ID_ANYFILES,
ID_FILE_1,
ID_FILE_2,
ID_FILE_3,
ID_FILE_4,
ID_FILE_5,
ID_FILE_6,
ID_FILE_7,
ID_FILE_8,
ID_FILE_9,
ID_FILE_10,
ID_FILE_11,
ID_FILE_12,
ID_FILE_13,
ID_FILE_14,
ID_FILE_15,
ID_FILE_16,
ID_FILE_17,
ID_FILE_18,
ID_FILE_19,
ID_FILE_20,
ID_FILE_21,
ID_FILE_22,
ID_FILE_23,
ID_FILE_24,
ID_FILE_25,
ID_FILE_26,
ID_FILE_27,
ID_FILE_28,
ID_FILE_29,
ID_FILE_30,
ID_FILE_31,
ID_FILE_32,
ID_LAST
};
public:
/**
* Make new recent files group.
* A Settings object and group name must be assigned prior to usage.
*/
FXRecentFiles();
/**
* Make new recent files group, using settings database from application.
* An optional target and message may be passed to invoke when one of the
* list of files is invoked.
*/
FXRecentFiles(FXApp* a,const FXString& gp="Recent Files",FXObject *tgt=nullptr,FXSelector sel=0);
/**
* Make new recent files group, using given settings database.
* An optional target and message may be passed to invoke when one of the
* list of files is invoked.
*/
FXRecentFiles(FXSettings* st,const FXString& gp="Recent Files",FXObject *tgt=nullptr,FXSelector sel=0);
/// Change settings database
void setSettings(FXSettings* s){ settings=s; }
/// Return settings database
FXSettings* getSettings() const { return settings; }
/// Change number of files we're tracking
void setMaxFiles(FXuint mx);
/// Return the maximum number of files being tracked
FXuint getMaxFiles() const { return maxfiles; }
/// Set group name
void setGroupName(const FXString& name){ group=name; }
/// Return group name
FXString getGroupName() const { return group; }
/// Change the target
void setTarget(FXObject *t){ target=t; }
/// Get the target
FXObject *getTarget() const { return target; }
/// Change the message
void setSelector(FXSelector sel){ message=sel; }
/// Return the message id
FXSelector getSelector() const { return message; }
/// Obtain the filename at index
FXString getFile(FXuint index) const;
/// Change the filename at index
void setFile(FXuint index,const FXString& filename);
/// Append a file
void appendFile(const FXString& filename);
/// Remove a file
void removeFile(const FXString& filename);
/// Clear the list of files
void clear();
/// Save to a stream
virtual void save(FXStream& store) const;
/// Load from a stream
virtual void load(FXStream& store);
/// Destructor
virtual ~FXRecentFiles();
};
}
#endif
|
