/*
* Copyright (c) 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: Interface to notify clients about trigger change 
* events
*
*/


#ifndef M_TRIGGERCHANGEOBSERVER_H
#define M_TRIGGERCHANGEOBSERVER_H


#include <e32cmn.h>

#include "lbtcontainer.h"

/**
 *  MLbtContainerChangeEventObserver is a an observer  
 *  
 *  @since S60 v4.0
 */
class MLbtContainerChangeEventObserver
    {

public:  // Interface methods

	/**
	 * 
	 */
	 enum TLbtContainerChangedAreaType
	 	{
	 	// None
	 	ETypeUnKnown = 0x0000,
	 	// Only Cicular triggers have changed
	 	ETypeCircularTriggerChange = 0x0001,
	 	// Only rectangular triggers have changed
	 	ETypeRectangularTriggerChange = 0x0002,
	 	// Only cellular triggers have changed
	 	ETypeCellularTriggerChange = 0x0004,
	 	// Hybrid triggers have changed
	 	ETypeHybridTriggerChange = 0x0010,
	 	// All the different type of triggers have changed
	 	ETypeAll = 0xFFFF
	 	};
	 
    /**
     * The method that has to be implemented to obtain events when the trigger
     * store is modified.
     *
     * @param[in] aTriggerIds aList of triggers that were changed. The ownership
     * is NOT transferred to the client. The client will have to delete this after 
     * processing the event.
     * @param[in] aEventMask The type of changes on the triggers. This is a 
     * bitmask of CLbtContainer::TLbtTriggerChangeEvent.
     *
     * @note To obtain the events, the client will have to set itself as an
     * observer using CLbtContainer::SetChangeObserver()
     * 
     * @note The client should not block this method for a long time.
     */
    virtual void TriggerStoreChanged( RArray<TLbtTriggerId>& aTriggerIds,
                                      TLbtTriggerEventMask aEventMask,
                                      TLbtContainerChangedAreaType aAreaType,
                                      RArray<TUid>& aManagerUids ) = 0;
    };

#endif      // M_TRIGGERCHANGEOBSERVER_H