/*
* Copyright (c) 2002-2006 Nokia Corporation and/or its subsidiary(-ies). 
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "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:  CNssDBTagSelectNotifier provides tag select notification to 
*               its clients (observers). It itslef receives tag select notification
*               from Recognition Handler.
*
*/


#ifndef NSSVASCDBTAGSELECTNOTIFIER_H
#define NSSVASCDBTAGSELECTNOTIFIER_H

#include <e32base.h>
#include "nssvascvasdatabase.h"
#include "nssvasmdbtagselectnotifierclient.h"


// CLASS DECLARATIONS
/**
*  CNssDBTagSelectNotifier provides tag select notification to its clients.
*  @lib NssVASApi.lib
*  @since 2.8
*/
class CNssDBTagSelectNotifier : public CActive
{
public:

   /**
   * 2 Phase construction
   * @param aVasDatabase - a pointer to the datatbase
   * @return a pointer to CNssDBTagSelectNotifier
   */
	static CNssDBTagSelectNotifier* NewL( CNssVASDatabase* aVasDatabase );
   
   /**
   * 2 Phase construction
   * @param aVasDatabase - a pointer to the datatbase
   * @return a pointer to CNssDBTagSelectNotifier
   */
	static CNssDBTagSelectNotifier* NewLC( CNssVASDatabase* aVasDatabase );
   
	/**
   * Destructor.
   */	
	~CNssDBTagSelectNotifier();
   
   /**
   * Register a client (observer) for tag select notification
   * @since 2.0
   * @param aObserver - MNssDBTagSelectNotifierClient 
   * @return error code
   */
   TInt RegisterForNotification( MNssDBTagSelectNotifierClient* aObserver );

   /**
   * Deregister a client (observer) from tag select notification
   * @since 2.0
   * @param aObserver - MNssDBTagSelectNotifierClient 
   * @return error code
   */
   TInt Deregister( MNssDBTagSelectNotifierClient* aObserver );

   /**
   * Handle selection, called by regconition when tag is selected
   * @since 2.0
   * @param None
   * @return None
   */
	void HandleSelection( CNssTag* aTag );

private:

    /**
    * C++ constructor
    */
    CNssDBTagSelectNotifier();

    /**
    * Overloaded C++constructor
    */
    CNssDBTagSelectNotifier( CNssVASDatabase* aVasDatabase );

    /**
    * Symbian construtor
    */
    void ConstructL ();

    /**
    * Handles selection of a tag based on tag and context ids
    *
    * @param "TInt aTagId" Tag identifier
    * @param "TInt aContextId" Context identifier
    */
    void DoHandleSelectionCallback( TInt aTagId, TInt aContextId );

private: // From CActive

    void RunL();
    void DoCancel();

private: 
	// pointer to the VAS datatbase
	CNssVASDatabase* iVasDatabase;

	// list of observers (clients)
	CArrayPtrFlat<MNssDBTagSelectNotifierClient> *iObserverList;
	
	// P&S handle
	RProperty iProperty;
	
	// Values read from P&S
	TInt iTagId;
	TInt iContextId;
};

#endif // NSSVASCDBTAGSELECTNOTIFIER_H

// End of file