75 |
80 |
76 public: |
81 public: |
77 /** |
82 /** |
78 * Set Widget name. |
83 * Set Widget name. |
79 * |
84 * |
80 * @since S60 5.0 |
85 * @since S60 5.2 |
81 * @param aName. Name of the widget. |
86 * @param aName. Name of the widget. |
82 * @return Reference to this |
87 * @return Reference to this |
83 */ |
88 */ |
84 IMPORT_C void SetNameL( const TDesC8& aName ); |
89 IMPORT_C void SetNameL( const TDesC8& aName ); |
85 |
90 |
86 /** |
91 /** |
87 * Set Widget name. |
92 * Set Widget name. |
88 * |
93 * |
89 * @since S60 5.0 |
94 * @since S60 5.2 |
90 * @param aName. Name of the widget. |
95 * @param aName. Name of the widget. |
91 * @return Reference to this |
96 * @return Reference to this |
92 */ |
97 */ |
93 IMPORT_C void SetNameL( const TDesC& aName ); |
98 IMPORT_C void SetNameL( const TDesC& aName ); |
94 |
99 |
95 /** |
100 /** |
96 * Set Widget's publisher Id . |
101 * Set Widget's publisher Id . |
97 * |
102 * |
98 * @since S60 5.0 |
103 * @since S60 5.2 |
99 * @param aPublisherId. Name of the publisher. |
104 * @param aPublisherId. Name of the publisher. |
100 * @return Reference to this |
105 * @return Reference to this |
101 */ |
106 */ |
102 IMPORT_C void SetPublisherIdL( const TDesC& aPublisherId ); |
107 IMPORT_C void SetPublisherIdL( const TDesC& aPublisherId ); |
103 |
108 |
104 /** |
109 /** |
105 * Set Widget id. |
110 * Set Widget id. |
106 * |
111 * |
107 * @since S60 5.0 |
112 * @since S60 5.2 |
108 * @param aUid Static uid of the widget. |
113 * @param aUid Static uid of the widget. |
109 * @return Reference to this |
114 * @return Reference to this |
110 */ |
115 */ |
111 IMPORT_C void SetUidL( const TDesC8& aUid ); |
116 IMPORT_C void SetUidL( const TDesC8& aUid ); |
112 |
117 |
113 /** |
118 /** |
114 * Set Widget plugin id. |
119 * Set Widget plugin id. |
115 * |
120 * |
116 * @since S60 5.0 |
121 * @since S60 5.2 |
117 * @param aId Dynamic id generated by hsps. |
122 * @param aId Dynamic id generated by hsps. |
118 * @return Reference to this |
123 * @return Reference to this |
119 */ |
124 */ |
120 IMPORT_C void SetPluginIdL( const TDesC8& aId ); |
125 IMPORT_C void SetPluginIdL( const TDesC8& aId ); |
121 |
126 |
122 /** |
127 /** |
123 * Set widget type. Possible values widget and template |
128 * Set widget type. Possible values widget and template |
124 * |
129 * |
125 * @since S60 5.0 |
130 * @since S60 5.2 |
126 * @param aType Widget type. |
131 * @param aType Widget type. |
127 */ |
132 */ |
128 IMPORT_C void SetTypeL( const TDesC8& aType ); |
133 IMPORT_C void SetTypeL( const TDesC8& aType ); |
129 |
134 |
130 /** |
135 /** |
131 * Access to widget name. |
136 * Access to widget name. |
132 * |
137 * |
133 * @since S60 5.0 |
138 * @since S60 5.2 |
134 * @return Reference to name |
139 * @return Reference to name |
135 */ |
140 */ |
136 IMPORT_C const TDesC& Name() const; |
141 IMPORT_C const TDesC& Name() const; |
137 |
142 |
138 /** |
143 /** |
139 * Access to widget's publisher id. |
144 * Access to widget's publisher id. |
140 * |
145 * |
141 * @since S60 5.0 |
146 * @since S60 5.2 |
142 * @return Reference to publisher id |
147 * @return Reference to publisher id |
143 */ |
148 */ |
144 IMPORT_C const TDesC& PublisherId() const; |
149 IMPORT_C const TDesC& PublisherId() const; |
145 |
150 |
146 /** |
151 /** |
147 * Access to widget uid. |
152 * Access to widget uid. |
148 * |
153 * |
149 * @since S60 5.0 |
154 * @since S60 5.2 |
150 * @return Uid or KNullDesC8 |
155 * @return Uid or KNullDesC8 |
151 */ |
156 */ |
152 IMPORT_C const TDesC8& Uid() const; |
157 IMPORT_C const TDesC8& Uid() const; |
153 |
158 |
154 /** |
159 /** |
155 * Access to widget name. |
160 * Access to widget name. |
156 * |
161 * |
157 * @since S60 5.0 |
162 * @since S60 5.2 |
158 * @return Reference to name |
163 * @return Reference to name |
159 */ |
164 */ |
160 IMPORT_C HBufC8* NameAs8BitLC() const; |
165 IMPORT_C HBufC8* NameAs8BitLC() const; |
161 |
166 |
162 /** |
167 /** |
163 * Access to widget plugin id. |
168 * Access to widget plugin id. |
164 * |
169 * |
165 * @since S60 5.0 |
170 * @since S60 5.2 |
166 * @return Plugin id or null if not set |
171 * @return Plugin id or null if not set |
167 */ |
172 */ |
168 IMPORT_C const TDesC8& PluginId() const; |
173 IMPORT_C const TDesC8& PluginId() const; |
169 |
174 |
170 /** |
175 /** |
171 * Set widget type. Possible values widget and template |
176 * Set widget type. Possible values widget and template |
172 * |
177 * |
173 * @since S60 5.0 |
178 * @since S60 5.2 |
174 * @return Type or KNullDesC8. |
179 * @return Type or KNullDesC8. |
175 */ |
180 */ |
176 IMPORT_C const TDesC8& Type() const; |
181 IMPORT_C const TDesC8& Type() const; |
177 |
182 |
178 /** |
183 /** |
183 IMPORT_C void SetMaxWidgets( TInt aMaxWidget ); |
188 IMPORT_C void SetMaxWidgets( TInt aMaxWidget ); |
184 |
189 |
185 /** |
190 /** |
186 * Get Maximum number of widgets |
191 * Get Maximum number of widgets |
187 * |
192 * |
|
193 * @since S60 5.2 |
188 * @return number of widgets or defaule value 1 |
194 * @return number of widgets or defaule value 1 |
189 */ |
195 */ |
190 IMPORT_C TInt MaxWidgets() const; |
196 IMPORT_C TInt MaxWidgets() const; |
191 |
197 |
192 /** |
198 /** |
193 * Externalize. |
199 * Externalize. |
194 * |
200 * |
|
201 * @since S60 5.2 |
195 * @param aStream A stream to externalize to |
202 * @param aStream A stream to externalize to |
196 */ |
203 */ |
197 IMPORT_C void ExternalizeL( RWriteStream& aStream ); |
204 IMPORT_C void ExternalizeL( RWriteStream& aStream ); |
198 |
205 |
199 /** |
206 /** |
200 * Sets whether this widget can be added to the active HS page |
207 * Sets whether this widget can be added to the active HS page |
201 * |
208 * |
202 * @since S60 5.0 |
209 * @since S60 5.2 |
203 * @param aValue ETrue if can be added, EFalse otherwise |
210 * @param aValue ETrue if can be added, EFalse otherwise |
204 */ |
211 */ |
205 IMPORT_C void SetCanBeAdded( TBool aValue ); |
212 IMPORT_C void SetCanBeAdded( TBool aValue ); |
206 |
213 |
207 /** |
214 /** |
208 * Queries whether this widget can be added to the active HS page |
215 * Queries whether this widget can be added to the active HS page |
209 * |
216 * |
210 * @since S60 5.0 |
217 * @since S60 5.2 |
211 * @return ETrue if can be added, EFalse otherwise |
218 * @return ETrue if can be added, EFalse otherwise |
212 */ |
219 */ |
213 IMPORT_C TBool CanBeAdded() const; |
220 IMPORT_C TBool CanBeAdded() const; |
214 |
221 |
215 /** |
222 /** |
216 * Sets whether this widget can be removed from the active HS page |
223 * Sets whether this widget can be removed from the active HS page |
217 * |
224 * |
218 * @since S60 5.0 |
225 * @since S60 5.2 |
219 * @param aValue ETrue if can be added, EFalse otherwise |
226 * @param aValue ETrue if can be added, EFalse otherwise |
220 */ |
227 */ |
221 IMPORT_C void SetCanBeRemoved( TBool aValue ); |
228 IMPORT_C void SetCanBeRemoved( TBool aValue ); |
222 |
229 |
223 /** |
230 /** |
224 * Queries whether this widget can be removed from the active HS page |
231 * Queries whether this widget can be removed from the active HS page |
225 * |
232 * |
226 * @since S60 5.0 |
233 * @since S60 5.2 |
227 * @return ETrue if can be removed, EFalse otherwise |
234 * @return ETrue if can be removed, EFalse otherwise |
228 */ |
235 */ |
229 IMPORT_C TBool CanBeRemoved() const; |
236 IMPORT_C TBool CanBeRemoved() const; |
230 |
237 |
231 /** |
238 /** |
232 * Sets this widget's installation time |
239 * Sets this widget's installation time |
233 * |
240 * |
234 * @since S60 5.0 |
241 * @since S60 5.2 |
235 * @param aTime Installation time |
242 * @param aTime Installation time |
236 */ |
243 */ |
237 IMPORT_C void SetInstallationTime( TTime& aTime ); |
244 IMPORT_C void SetInstallationTime( TTime& aTime ); |
238 |
245 |
239 /** |
246 /** |
240 * Gets this widget's installation time |
247 * Gets this widget's installation time |
241 * |
248 * |
242 * @since S60 5.0 |
249 * @since S60 5.2 |
243 * @return Installation time |
250 * @return Installation time |
244 */ |
251 */ |
245 IMPORT_C TTime InstallationTime() const; |
252 IMPORT_C TTime InstallationTime() const; |
246 |
253 |
247 /** |
254 /** |
248 * Sets this widget's description |
255 * Sets this widget's description |
249 * |
256 * |
250 * @since S60 5.0 |
257 * @since S60 5.2 |
251 * @param aDescription Description |
258 * @param aDescription Description |
252 */ |
259 */ |
253 IMPORT_C void SetDescriptionL( const TDesC& aDescription ); |
260 IMPORT_C void SetDescriptionL( const TDesC& aDescription ); |
254 |
261 |
255 /** |
262 /** |
256 * Sets this widget's description |
263 * Sets this widget's description |
257 * |
264 * |
258 * @since S60 5.0 |
265 * @since S60 5.2 |
259 * @param aDescription Description |
266 * @param aDescription Description |
260 */ |
267 */ |
261 IMPORT_C void SetDescriptionL( const TDesC8& aDescription ); |
268 IMPORT_C void SetDescriptionL( const TDesC8& aDescription ); |
262 |
269 |
263 /** |
270 /** |
264 * Gets this widget's description |
271 * Gets this widget's description |
265 * |
272 * |
266 * @since S60 5.0 |
273 * @since S60 5.2 |
267 * @return Description |
274 * @return Description |
268 */ |
275 */ |
269 IMPORT_C const TDesC& Description() const; |
276 IMPORT_C const TDesC& Description() const; |
270 |
277 |
271 /** |
278 /** |
272 * Sets this widget's icon path |
279 * Sets this widget's icon path |
273 * |
280 * |
274 * @since S60 5.0 |
281 * @since S60 5.2 |
275 * @param aPath Path |
282 * @param aPath Path |
276 */ |
283 */ |
277 IMPORT_C void SetIconPathL( const TDesC& aIconPath ); |
284 IMPORT_C void SetIconPathL( const TDesC& aIconPath ); |
278 |
285 |
279 /** |
286 /** |
280 * Gets this widget's icon path |
287 * Gets this widget's icon path |
281 * |
288 * |
282 * @since S60 5.0 |
289 * @since S60 5.2 |
283 * @return Path |
290 * @return Path |
284 */ |
291 */ |
285 IMPORT_C const TDesC& IconPath() const; |
292 IMPORT_C const TDesC& IconPath() const; |
286 |
293 |
287 /** |
294 /** |
288 * Internalize |
295 * Internalize |
|
296 * |
|
297 * @since S60 5.2 |
289 * @param aStream A stream where the class is internalized |
298 * @param aStream A stream where the class is internalized |
290 * |
|
291 * @since S60 5.0 |
|
292 */ |
299 */ |
293 IMPORT_C void InternalizeL( RReadStream& aStream ); |
300 IMPORT_C void InternalizeL( RReadStream& aStream ); |
294 |
301 |
295 /** |
302 /** |
296 * Returns size of a descriptor needed to externalize the class |
303 * Returns size of a descriptor needed to externalize the class |
297 * |
304 * |
298 * @since S60 5.0 |
305 * @since S60 5.2 |
299 */ |
306 */ |
300 IMPORT_C TInt Size(); |
307 IMPORT_C TInt Size(); |
301 |
308 |
302 /** |
309 /** |
303 * Set WRT widget publisher uid. |
310 * Set WRT widget publisher uid. |
304 * |
311 * |
305 * @since S60 5.0 |
312 * @since S60 5.2 |
306 * @param aUid Publisher uid of the wrt widget. |
313 * @param aUid Publisher uid of the wrt widget. |
307 * @return Reference to this |
314 * @return Reference to this |
308 */ |
315 */ |
309 IMPORT_C void SetPublisherUidL( const TDesC8& aUid ); |
316 IMPORT_C void SetPublisherUidL( const TDesC8& aUid ); |
310 |
317 |
311 /** |
318 /** |
312 * Access to WRT widget publisher uid. |
319 * Access to WRT widget publisher uid. |
313 * |
320 * |
314 * @since S60 5.0 |
321 * @since S60 5.2 |
315 * @return PublisherUid or KNullDesC8 |
322 * @return PublisherUid or KNullDesC8 |
316 */ |
323 */ |
317 IMPORT_C const TDesC8& PublisherUid() const; |
324 IMPORT_C const TDesC8& PublisherUid() const; |
318 |
325 |
319 /** |
326 /** |
320 * Sets whether this is a WRT widget |
327 * Sets whether this is a WRT widget |
321 * |
328 * |
322 * @since S60 5.0 |
329 * @since S60 5.2 |
323 * @param aIsWrt, ETrue if is WRT |
330 * @param aIsWrt, ETrue if is WRT |
324 */ |
331 */ |
325 IMPORT_C void SetIsWrt( TBool aIsWrt ); |
332 IMPORT_C void SetIsWrt( TBool aIsWrt ); |
326 |
333 |
327 /** |
334 /** |
328 * Returns whether this is a WRT widget |
335 * Returns whether this is a WRT widget |
329 * |
336 * |
330 * @since S60 5.0 |
337 * @since S60 5.2 |
331 * @return ETrue if WRT, EFalse otherwise |
338 * @return ETrue if WRT, EFalse otherwise |
332 */ |
339 */ |
333 IMPORT_C TBool IsWrt() const; |
340 IMPORT_C TBool IsWrt() const; |
334 |
341 |
335 /** |
342 /** |
336 * Sets whether an application confguration or a view is full |
343 * Sets whether an application confguration or a view is full |
337 * |
344 * |
338 * @since S60 5.0 |
345 * @since S60 5.2 |
339 * @param aIsFull, ETrue if application configuration or a view is full |
346 * @param aIsFull, ETrue if application configuration or a view is full |
340 */ |
347 */ |
341 IMPORT_C void SetIsFull( TBool aIsFull ); |
348 IMPORT_C void SetIsFull( TBool aIsFull ); |
342 |
349 |
343 /** |
350 /** |
344 * Returns whether an application configuration or a view is full |
351 * Returns whether an application configuration or a view is full |
345 * |
352 * |
346 * @since S60 5.0 |
353 * @since S60 5.2 |
347 * @return ETrue if application configuration or view is full, |
354 * @return ETrue if application configuration or view is full, |
348 * EFalse otherwise |
355 * EFalse otherwise |
349 */ |
356 */ |
350 IMPORT_C TBool IsFull() const; |
357 IMPORT_C TBool IsFull() const; |
351 |
358 |
352 /** |
359 /** |
353 * Marshals Content Info data to a descriptor |
360 * Marshals Content Info data to a descriptor |
354 * |
361 * |
355 * @since S60 5.0 |
362 * @since S60 5.2 |
356 * @return Descriptor containing the externalized Content Info data |
363 * @return Descriptor containing the externalized Content Info data |
357 */ |
364 */ |
358 IMPORT_C HBufC8* MarshalL(); |
365 IMPORT_C HBufC8* MarshalL(); |
359 |
366 |
360 private: // Data |
367 private: // Data |