1 /*

     2 * Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:    Media userinterface

    15 *

    16 */

    17 

    18 

    19 

    20 

    21 #ifndef __M_GLXMEDIAUSER_H__

    22 #define __M_GLXMEDIAUSER_H__

    23 

    24 #include <e32std.h>

    25 

    26 #include <mpxattribute.h>

    27 

    28 #include "glxmediaid.h"

    29 

    30 class CGlxMedia;

    31 

    32 /**

    33  * Interface for media object users

    34  * @author Aki Vanhatalo

    35  *

    36  * @internal reviewed 17/07/2007 by Kimmo Hoikka

    37  *

    38  * @ingroup mlm_media_list_manager_design

    39  */

    40 class MGlxMediaUser

    41     {

    42 public:

    43     /**

    44      * For a given item, get all the attributes that may be requested for it

    45      *

    46      * @param aIndex index in media list of item

    47      * @param aAttributes Ordered list of attributes (ordered by AttributeOrder)

    48      * @return aAttributes with any new attributes added

    49      */

    50     virtual void GetRequiredAttributesL( TInt aIndex, RArray< TMPXAttribute >& aAttributes ) = 0;

    51     

    52     /**

    53      * Called to notify the list that attributes for the item are available

    54      *

    55      * @param aIndex index in media list of item that has attributes available

    56      * @param aAttributes list of attributes available

    57      */

    58     virtual void HandleAttributesAvailableL( TInt aIndex, 

    59         const RArray< TMPXAttribute >& aAttributes ) = 0;

    60     

    61     /**

    62      * Called to notify that the callee should remove all references to the 

    63      * media object (as it is about to be deleted)

    64      * @param aIndex index in media list of item to which references should be removed

    65      */

    66     virtual void RemoveReference( TInt aIndex ) = 0;

    67 

    68     /**

    69      * Notify of error

    70      *

    71      * @param aError Error code

    72      */

    73     virtual void HandleError( TInt aError ) = 0;

    74     };

    75     

    76 #endif // __M_GLXMEDIAUSER_H__