williamr@2: /*
williamr@2: * Copyright (c) 2002-2006 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: * All rights reserved.
williamr@2: * This component and the accompanying materials are made available
williamr@2: * under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
williamr@2: * which accompanies this distribution, and is available
williamr@2: * at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2: *
williamr@2: * Initial Contributors:
williamr@2: * Nokia Corporation - initial contribution.
williamr@2: *
williamr@2: * Contributors:
williamr@2: *
williamr@2: * Description:   Encapsulates message real addressa and alias
williamr@2: *
williamr@2: */
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: #ifndef C_MESSAGEADDRESS_H
williamr@2: #define C_MESSAGEADDRESS_H
williamr@2: 
williamr@2: #include <e32Base.h>
williamr@2: 
williamr@2: class CMessageAddressImpl;
williamr@2: class RWriteStream;
williamr@2: class RReadStream;
williamr@2: 
williamr@2: /**
williamr@2:  *  Encapsulates message recipient real address and alias.
williamr@2:  *
williamr@2:  *  @lib sendui
williamr@2:  *  @since S60 v3.0
williamr@2:  */
williamr@2: class CMessageAddress : public CBase
williamr@2: {
williamr@2: public:  // Constructors and destructor
williamr@2: 
williamr@2:     /**
williamr@2:     * Two-phased constructor.
williamr@2:     */
williamr@2:     IMPORT_C static CMessageAddress* NewL();
williamr@2:     
williamr@2:     /**
williamr@2:     * Two-phased constructor. Leaves object to cleanup stack.
williamr@2:     */
williamr@2:     IMPORT_C static CMessageAddress* NewLC();
williamr@2:     
williamr@2:     /**
williamr@2:     * Destructor.
williamr@2:     */
williamr@2:     IMPORT_C virtual ~CMessageAddress();
williamr@2: 
williamr@2: public: // New functions
williamr@2: 
williamr@2:    /**
williamr@2:     * Sets real address.
williamr@2:     *
williamr@2:     * @since Series 60 3.0
williamr@2:     * @param aAddress Real address.
williamr@2:     * @return None.
williamr@2:     */
williamr@2:     IMPORT_C void SetAddressL( const TDesC& aAddress );
williamr@2: 
williamr@2:    /**
williamr@2:     * Returns real address.
williamr@2:     *
williamr@2:     * @since Series 60 3.0
williamr@2:     * @return Real address.
williamr@2:     */
williamr@2:     IMPORT_C const TPtrC Address() const;
williamr@2: 
williamr@2:     /**
williamr@2:     * Sets alias for the real address.
williamr@2:     *
williamr@2:     * @since Series 60 3.0
williamr@2:     * @param aAlias Alias for the real address.
williamr@2:     * @return None.
williamr@2:     */
williamr@2:     IMPORT_C void SetAliasL( const TDesC& aAlias );
williamr@2: 
williamr@2:    /**
williamr@2:     * Returns alias for the address.
williamr@2:     *
williamr@2:     * @since Series 60 3.0
williamr@2:     * @return Alias for the real address.
williamr@2:     */
williamr@2:     IMPORT_C const TPtrC Alias() const;
williamr@2: 
williamr@2:     /**
williamr@2:     * Externalizes address data to a stream
williamr@2:     *
williamr@2:     * @since Series 60 3.2
williamr@2:     * @param aStream Destination stream
williamr@2:     * @return None.
williamr@2:     */ 
williamr@2:     IMPORT_C void ExternalizeL( RWriteStream& aStream );
williamr@2:     
williamr@2:     /**
williamr@2:     * Internalizes message data from a stream
williamr@2:     *
williamr@2:     * @since Series 60 3.2
williamr@2:     * @param Source stream
williamr@2:     * @return None.
williamr@2:     */ 
williamr@2:     IMPORT_C void InternalizeL( RReadStream& aStream );
williamr@2: 
williamr@2: private:
williamr@2:     
williamr@2:     /**
williamr@2:     * C++ default constructor.
williamr@2:     */
williamr@2:     CMessageAddress();
williamr@2:     
williamr@2:     /**
williamr@2:     * Symbian 2nd phase constructor.
williamr@2:     */
williamr@2:     void ConstructL();
williamr@2: 
williamr@2: private:  // Data
williamr@2: 
williamr@2:     /**
williamr@2:      * Message address implementation.
williamr@2:      * Own.
williamr@2:      */
williamr@2:     CMessageAddressImpl* iMessageAddressImpl;
williamr@2:     };
williamr@2: 
williamr@2: /**  Address array */
williamr@2:    
williamr@2: typedef CArrayPtrFlat<CMessageAddress> CMessageAddressArray;
williamr@2: 
williamr@2: #endif      // C_MESSAGEADDRESS_H
williamr@2: 
williamr@2: // End of File