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
|
/*
ktnefattach.h
Copyright (C) 2002 Michael Goffioul <kdeprint@swing.be>
This file is part of KTNEF, the KDE TNEF support library/program.
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
/**
* @file
* This file is part of the API for handling TNEF data and
* defines the KTNEFAttach class.
*
* @author Michael Goffioul
*/
#ifndef KTNEFATTACH_H
#define KTNEFATTACH_H
#include <QtCore/QMap>
#include <QtCore/QString>
#include <QtCore/QVariant>
#include "ktnefpropertyset.h"
#include "ktnef_export.h"
namespace KTnef { class KTNEFProperty; }
namespace KTnef {
/**
* @brief
* Represents a @acronym TNEF attachment.
*/
class KTNEF_EXPORT KTNEFAttach : public KTNEFPropertySet
{
public:
/**
* The different attachment parsed states.
*/
enum ParseState {
Unparsed = 0x0000, /**< Unparsed */
TitleParsed = 0x0001, /**< The title is parsed */
DataParsed = 0x0002, /**< The data is parsed */
InfoParsed = 0x0004 /**< The info is parsed */
};
/**
* Constructs a @acronym TNEF attachment.
*/
KTNEFAttach();
/**
* Destroys the @acronym TNEF attachment.
*/
~KTNEFAttach();
/**
* Sets the #TitleParsed flag for this attachment.
*/
void setTitleParsed();
/**
* Sets the #DataParsed flag for this attachment.
*/
void setDataParsed();
/**
* Unsets the #DataParsed flag for this attachment.
*/
void unsetDataParser();
/**
* Sets the #InfoParsed flag for this attachment.
*/
void setInfoParsed();
/**
* Returns true if the #TitleParsed flag is set; else returns false.
*/
bool titleParsed() const;
/**
* Returns true if the ParseState::DataParsed flag is set; else returns false.
*/
bool dataParsed() const;
/**
* Returns true if the #InfoParsed flag is set; else returns false.
*/
bool infoParsed() const;
/**
* Sets/Unsets the attachment state according to the @p state flag
* must be a #ParseState type.
*
* @param state a #ParseState type.
* @return true if the state is turned-on; else returns false.
*/
bool checkState( int state ) const;
/**
* Sets the offset value of this attachment to @p offset.
*
* @param offset is the attachment offset to set.
*/
void setOffset( int offset );
/**
* Returns the offset value of the attachment.
*/
int offset() const;
/**
* Sets the size of the attachment to @p size.
*
* @param size is the attachment size to set.
*/
void setSize( int size );
/**
* Returns the size of the attachment.
*/
int size() const;
/**
* Sets the display size of the attachment to @p size.
*
* @param size is the attachment display size to set.
*/
void setDisplaySize( int size );
/**
* Returns the display size of the attachment.
*/
int displaySize() const;
/**
* Sets the name of this attachment to @p str.
*
* @param str is attachment name to set.
*/
void setName( const QString &str );
/**
* Returns the name of the attachment.
*/
QString name() const;
/**
* Sets the index of this attachment to @p indx.
*
* @param indx is the attachment index to set.
*/
void setIndex( int indx );
/**
* Returns the index of the attachment.
*/
int index() const;
/**
* Sets the filename of this attachment to @p str.
*
* @param str is the attachment filename to set.
*/
void setFileName( const QString &str );
/**
* Returns the filename of the attachment.
*/
QString fileName() const;
/**
* Sets the display name of this attachment to @p str.
*
* @param str is the attachment display name to set.
*/
void setDisplayName( const QString &str );
/**
* Returns the display name of the attachment.
*/
QString displayName() const;
/**
* Sets the @acronym MIME tag of this attachment to @p str.
*
* @param str is the attachment @acronym MIME tag to set.
*/
void setMimeTag( const QString &str );
/**
* Returns the @acronym MIME tag of the attachment.
*/
QString mimeTag() const;
/**
* Sets the filename extension of this attachment to @p str.
*
* @param str is the attachment filename extension to set.
*/
void setExtension( const QString &str );
/**
* Returns the filename extension of the attachment.
*/
QString extension() const;
private:
//@cond PRIVATE
class AttachPrivate;
AttachPrivate *const d;
//@endcond
Q_DISABLE_COPY( KTNEFAttach )
};
}
#endif
|