diff -r 000000000000 -r 2c201484c85f contentmgmt/contentaccessfwfordrm/inc/attributeset.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/contentmgmt/contentaccessfwfordrm/inc/attributeset.h Wed Jul 08 11:25:26 2009 +0100 @@ -0,0 +1,131 @@ +/* +* Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "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: +* +*/ + + + + +/** + @file + @publishedPartner + @released +*/ + + +#ifndef __ATTRIBUTESET_H__ +#define __ATTRIBUTESET_H__ + +#include +#include + +class RReadStream; +class RWriteStream; + +namespace ContentAccess + { + + /** Holds the values of a predefined set of attributes based upon + ContentAccess::TAttribute + + It is also possible for an agent to provide an extended set of these + attributes beyond EAgentSpecificAttributeBase but only applications written + to support a that particular agent will support this. + + No duplicate attributes are allowed in the set + + @publishedPartner + @released + */ + class RAttributeSet + { + /** Holds the value of an attribute along with any error encountered + while retrieving the attribute + */ + class TAttributeValue + { + public: + TInt iAttribute; + TInt iValue; + TInt iError; + }; + + public: + IMPORT_C RAttributeSet(); + + /** Release all resources used by the RAttributeSet + + This must be called before the RAttribute set goes out of scope + */ + IMPORT_C void Close(); + + /** Add a new attribute to the set + The attribute is initalised with a default value of EAttributeNotSupported + + @param aAttribute The attribute to add to the set + */ + IMPORT_C void AddL(TInt aAttribute); + + /** Get the value of a specified attribute + @param aAttribute The attribute to query + @param aValue The value of the attribute + @return Whether the value parameter was updated + @return KErrNone The attribute value was updated + @return KErrNotFound The attribute is not part of the set + */ + IMPORT_C TInt GetValue(TInt aAttribute, TInt& aValue) const; + + /** Set the value of an attribute within the set + @param aAttribute The attribute to set + @param aValue The value of the attribute + @param aErrorCode The error code to return when this attribute is requested via the GetValue() function + @return Whether the new attribute value was set + @return KErrNone if the value was set + @return KErrNotFound if the attribute is not part of the set + */ + IMPORT_C TInt SetValue(TInt aAttribute, TInt aValue, TInt aErrorCode); + + /** Find the attribute stored at a particular index in the set + @param aIndex The index of the attribute + @return The attribute, NOT the value of the attribute + */ + IMPORT_C TInt operator [] (TInt aIndex) const; + + /** The number of attributes in the set + @return The number of attributes in the set + */ + IMPORT_C TInt Count() const; + + /** Write the RAttributeSet to a stream + @param aStream The stream to write the attribute set to + */ + IMPORT_C void ExternalizeL(RWriteStream& aStream) const; + + /** Read the RAttributeSet from a stream + This does not clear the contents of the attribute set before reading. The + values of any attributes already in the set are updated with new values + from the stream. New attributes from the stream and their values are added + to the set. + @param aStream The stream to read the attribute set from + */ + IMPORT_C void InternalizeL(RReadStream& aStream); + + private: + void AddL(TInt aAttribute, TInt aValue, TInt aErrorCode); + + RArray iAttributes; + }; + } +#endif