/*

* Copyright (c) 2007 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:  receives key pressed notifications

*

*/

#ifndef M_MMDRAGANDDROPOBSERVER_H

#define M_MMDRAGANDDROPOBSERVER_H

/**

 *  Used by Multimedia Menu widgets to notify about dragging events.

 *  Whenever a drag begins HandleDragStartL() is invoked.

 *  When the highlight changes during drag, HandleDragOverL() is invoked.

 *  When item is dropped, HandleDragStopL() is invoked.

 *  The set of the three methods fully notifies the observer about the state 

 *  of the drag.

 *

 *  @code

 *  @endcode

 *  @lib mmwidgets

 *  @since S60 v3.0

 *  @ingroup group_mmwidgets

 */

class MMmDragAndDropObserver

    {

public:

    /**

     * Method is invoked on the observer, when the dragging starts.

     *

     * @since S60 v5.0

     * @param aModelItemIndex Index of item that has started dragging.

     */

    virtual void HandleDragStartL( TInt aModelItemIndex ) = 0;

    /**

     * Method is invoked on the observer, when highlight changes

     * while dragging.

     *

     * @since S60 v5.0

     * @param aModelItemIndex Index of item that the dragged item hovers over.

     */

    virtual void HandleDragOverL( TInt aModelItemIndex ) = 0;

    /**

     * Method is invoked on the observer, when the item is dropped.

     *

     * @since S60 v5.0

     * @param aModelItemIndex Index of item on which the draging stops.

     */

    virtual void HandleDragStopL( TInt aModelItemIndex ) = 0;

    /**

     * Method is invoked on the observer, when the dragged item index changes.

     *

     * @since S60 v5.0

     * @param aModelItemIndex Index of item on which the draging stops.

     */

    virtual void HandleDraggedIndexUpdatedL( TInt aModelItemIndex ) = 0;

    };

#endif // M_MMDRAGANDDROPOBSERVER_H