homescreensrv_plat/hs_content_control_api/inc/hscontentinfo.h
branchRCL_3
changeset 78 1b207dd38b72
parent 59 a0713522ab97
equal deleted inserted replaced
74:edd621764147 78:1b207dd38b72
     1 /*
     1 /*
     2 * Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
     2 * Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
     3 * All rights reserved.
     3 * All rights reserved.
     4 * This component and the accompanying materials are made available
     4 * This component and the accompanying materials are made available
     5 * under the terms of "Eclipse Public License v1.0"
     5 * under the terms of "Eclipse Public License v1.0"
     6 * which accompanies this distribution, and is available
     6 * which accompanies this distribution, and is available
     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
    26 // Forward declarations
    26 // Forward declarations
    27 
    27 
    28 /**
    28 /**
    29  *  Content data
    29  *  Content data
    30  *
    30  *
    31  *
    31  *  @lib hscontentinfo.lib
    32  *  @code
    32  *  @since S60 v5.2
    33  *
       
    34  *  @endcode
       
    35  *
       
    36  *  @lib hscontentcontrol.lib
       
    37  *  @since S60 v5.0
       
    38  */
    33  */
    39 NONSHARABLE_CLASS( CHsContentInfo ) : public CBase
    34 NONSHARABLE_CLASS( CHsContentInfo ) : public CBase
    40     {
    35     {
    41     public:
    36     public:
    42     /**
    37     /**
    43      * Two-phased constructor.
    38      * Two-phased constructor.
       
    39      *
       
    40      * @since S60 v5.2
    44      */
    41      */
    45     IMPORT_C static CHsContentInfo* NewL();
    42     IMPORT_C static CHsContentInfo* NewL();
    46     
    43     
    47     /**
    44     /**
    48      * Two-phased constructor.
    45      * Two-phased constructor.
       
    46      *
       
    47      * @since S60 v5.2
    49      */    
    48      */    
    50     IMPORT_C static CHsContentInfo* NewL( RReadStream& aStream );
    49     IMPORT_C static CHsContentInfo* NewL( RReadStream& aStream );
    51     
    50     
    52     /**
    51     /**
    53      * Two-phased constructor.
    52      * Two-phased constructor.
       
    53      *
       
    54      * @since S60 v5.2
    54      */    
    55      */    
    55     IMPORT_C static CHsContentInfo* NewLC();
    56     IMPORT_C static CHsContentInfo* NewLC();
    56     
    57     
    57     /**
    58     /**
    58      * Clone.
    59      * Clone.
       
    60      *
       
    61      * @since S60 v5.2
    59      */
    62      */
    60 	IMPORT_C CHsContentInfo* CloneL();
    63 	IMPORT_C CHsContentInfo* CloneL();
    61 
    64 
    62     /**
    65     /**
    63      * Destructor.
    66      * Destructor.
       
    67      *
       
    68      * @since S60 v5.2
    64      */
    69      */
    65     ~CHsContentInfo();
    70     ~CHsContentInfo();
    66 
    71 
    67 private:
    72 private:
    68     /**
    73     /**
    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