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
|
/*
* Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
*
*/
#if !defined(__CNTFLDST_H__)
#define __CNTFLDST_H__
#if !defined(__E32BASE_H__)
#include <e32base.h>
#endif
#if !defined(__BAMDESCA_H__)
#include <bamdesca.h>
#endif
#if !defined(__S32STD_H__)
#include <s32std.h>
#endif
#if !defined(__CNTDEF_H__)
#include <cntdef.h>
#endif
#define KTextStreamSeparator 0x00
class CStreamStore;
class CContactFieldStorage : public CBase
/** Abstract base class for the different types of contact field data storage.
CContactTextField, CContactStoreField, CContactAgentField, CContactDateField
and CContactNumberField are all derived from this class.
A pointer to the base class can be obtained by calling CContactItemField::Storage().
Pointers to the derived classes can be retrieved by calling CContactItemField::TextStorage(),
CContactItemField::StoreStorage() etc.
@publishedAll
@released
*/
{
public:
/** Internalises the field data.
@param aStream Stream from which the the contents of the field should be internalised. */
virtual void InternalizeL( RReadStream& aStream)=0;
/** Externalises the field data.
@param aStream Write stream to which the contents of the field should be externalised. */
virtual void ExternalizeL(RWriteStream& aStream) const=0;
/** Stores the field data.
@param aStore Reference to the stream store to which the field data is written.
@return The ID of the stream store. */
virtual TStreamId StoreL(CStreamStore& aStore) const=0;
/** Restores the field data.
@param aStore Reference to the store from which the object is to be restored.
@param aStream Reference to the stream which should be passed to InternalizeL(). */
virtual void RestoreL(CStreamStore& aStore,RReadStream& aStream)=0;
/** Tests whether the field storage contains data.
@return True if the field storage contains data, false if not. */
virtual TBool IsFull() const=0;
private:
IMPORT_C virtual void CContactFieldStorage_Reserved1();
TAny* CContactFieldStorage_Reserved;
};
class CContactTextField : public CContactFieldStorage
/** Provides access to the text stored in a contact item field.
An object of this class can be retrieved using CContactItemField::TextStorage().
@publishedAll
@released
*/
{
public:
IMPORT_C ~CContactTextField();
public:
void InternalizeL(HBufC *aTextStream,TInt aTextFieldIndex);
void InternalizeL(RReadStream& aStream);
void ExternalizeL(RWriteStream& aStream) const;
void ExternalizeL(RWriteStream& aStream,TBool aIsInlineBlob,TInt aTextFieldIndex) const;
TStreamId StoreL(CStreamStore& aStore) const;
void RestoreL(CStreamStore& aStore,RReadStream& aStream);
IMPORT_C void SetTextL(const TDesC& aText);
IMPORT_C void SetText(HBufC *aHbuf);
IMPORT_C void SetTextArray(MDesCArray* anArray);
IMPORT_C TPtrC Text() const;
TBool IsFull() const;
IMPORT_C TPtrC StandardTextLC() const;
IMPORT_C void SetStandardTextL(const TDesC& aText);
IMPORT_C void SetStandardTextArray(MDesCArray* anArray);
private:
HBufC *EncodeL(const TDesC& aText,TUid aConversion) const;
IMPORT_C /*virtual*/ void CContactFieldStorage_Reserved1();
private:
HBufC* iText;
};
class CContactStoreField : public CContactFieldStorage
/** Provides access to the binary field data stored in an 8-bit descriptor.
An object of this class can be retrieved using CContactItemField::StoreStorage().
@publishedAll
@released
*/
{
public:
~CContactStoreField();
TStreamId StoreL(CStreamStore& aStore) const;
void RestoreL(CStreamStore& aStore,RReadStream& aStream);
IMPORT_C void SetThingL(const TDesC8& aDes);
IMPORT_C void SetThingL(const HBufC8& aDes);
IMPORT_C void SetThingL(const CBufBase* aBuf);
IMPORT_C HBufC8* Thing() const;
void InternalizeL(RReadStream& aStream);
void ExternalizeL(RWriteStream& aStream) const;
TBool IsFull() const;
private:
IMPORT_C /*virtual*/ void CContactFieldStorage_Reserved1();
private:
HBufC8* iThing;
};
class CContactAgentField : public CContactFieldStorage
/** Provides access to an agent ID.
An agent is a field in a contact item which contains another person's
contact details. It corresponds to the agent property in the vCard
specification (version 2.1). The agent is identified by an agent ID
(a TContactItemId).
An object of this class can be retrieved using CContactItemField::AgentStorage().
@publishedAll
@released
*/
{
public:
TStreamId StoreL(CStreamStore& aStore) const;
void RestoreL(CStreamStore& aStore,RReadStream& aStream);
IMPORT_C void SetAgentId(TContactItemId aId);
IMPORT_C TContactItemId Value() const;
void InternalizeL( RReadStream& aStream);
void ExternalizeL(RWriteStream& aStream) const;
TBool IsFull() const;
private:
IMPORT_C /*virtual*/ void CContactFieldStorage_Reserved1();
private:
TContactItemId iAgentId;
};
class CContactDateField : public CContactFieldStorage
/** Provides access to the date/time value stored in a contact item field.
An object of this class can be retrieved using CContactItemField::DateTimeStorage().
@publishedAll
@released
*/
{
public:
CContactDateField();
TStreamId StoreL(CStreamStore& aStore) const;
void RestoreL(CStreamStore& aStore,RReadStream& aStream);
IMPORT_C void SetTime(TTime aTime);
IMPORT_C void SetTime(TDateTime aDateTime);
IMPORT_C TTime Time() const;
void InternalizeL( RReadStream& aStream);
void ExternalizeL(RWriteStream& aStream) const;
TBool IsFull() const;
private:
IMPORT_C /*virtual*/ void CContactFieldStorage_Reserved1();
private:
TTime iTime;
};
#endif
|
