williamr@2: /*
williamr@2: * Copyright (c) 2002-2004 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: * All rights reserved.
williamr@2: * This component and the accompanying materials are made available
williamr@4: * under the terms of "Eclipse Public License v1.0"
williamr@2: * which accompanies this distribution, and is available
williamr@4: * at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@2: *
williamr@2: * Initial Contributors:
williamr@2: * Nokia Corporation - initial contribution.
williamr@2: *
williamr@2: * Contributors:
williamr@2: *
williamr@2: * Description: Interface to get the list of the alert tones from MProEngAlertToneSeeker.
williamr@2: *
williamr@2: */
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: #ifndef MPROENGALERTTONESEEKEROBSERVER_H
williamr@2: #define MPROENGALERTTONESEEKEROBSERVER_H
williamr@2: 
williamr@2: //  INCLUDES
williamr@2: #include <e32def.h>
williamr@2: 
williamr@2: // FORWARD DECLARATIONS
williamr@2: class MProEngAlertToneSeekerObserverExt;
williamr@2: 
williamr@2: // CLASS DECLARATION
williamr@2: 
williamr@2: /**
williamr@2: *  Interface to get the list of the alert tones from MProEngAlertToneSeeker.
williamr@2: *  @lib ProfileEngine.lib
williamr@2: *  @since Series 60 3.1
williamr@2: */
williamr@2: class MProEngAlertToneSeekerObserver
williamr@2:     {
williamr@2:     public: // New functions
williamr@2: 
williamr@2:         /**
williamr@2:         * Abstract method to get notification when the MProEngAlertToneSeeker
williamr@2:         * has completed the list of alert tones.
williamr@2:         * @since Series 60 3.1
williamr@2:         * @param aToneList Array containing the path names of the tones found.
williamr@2:         * The ownership of the array is transferred to the observer.
williamr@2:         */
williamr@2:         virtual void HandleAlertToneListCompletedL( MDesCArray* aToneList ) = 0;
williamr@2: 
williamr@2:         /**
williamr@2:         * Abstract method for handling errors in alert tone list creation
williamr@2:         * process. Also if HandleAlertToneListCompletedL() method leaves, the
williamr@2:         * leave code will be passed to this method.
williamr@2:         * @since Series 60 3.1
williamr@2:         * @param aError System wide error code.
williamr@2:         */
williamr@2:         virtual void HandleError( TInt aError ) = 0;
williamr@2: 
williamr@2:     protected:
williamr@2: 
williamr@2:         /**
williamr@2:         * Destructor.
williamr@2:         */
williamr@2:         virtual ~MProEngAlertToneSeekerObserver() {}
williamr@2: 
williamr@2:     private: // Extension interface
williamr@2: 
williamr@2:         /**
williamr@2:         * This member is internal and not intended for use.
williamr@2:         */
williamr@2:         virtual MProEngAlertToneSeekerObserverExt* Extension() { return NULL; }
williamr@2: 
williamr@2:     };
williamr@2: 
williamr@2: #endif      // MPROENGALERTTONESEEKEROBSERVER_H
williamr@2: 
williamr@2: // End of File
williamr@2: