1 /*

     2 * Copyright (c) 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:   MIAUpdateHistory

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef IA_UPDATE_HISTORY_H

    21 #define IA_UPDATE_HISTORY_H

    22 

    23 #include <e32cmn.h>

    24 

    25 class MIAUpdateHistoryItem;

    26 

    27 

    28 /**

    29  * MIAUpdateHistory interface provides history items.

    30  *

    31  * @since S60 v3.2

    32  */

    33 class MIAUpdateHistory

    34     {

    35 

    36 public: 

    37     

    38     /**

    39      * Destructor

    40      *

    41      * @since S60 v3.2

    42      */

    43     virtual ~MIAUpdateHistory() { }

    44     

    45     /**

    46      * @note Array items are arranged in following order

    47      *       1. Items whose updates have not been completed 

    48      *          correctly are shown first.

    49      *       2. Items having a same status are arranged so, 

    50      *          that latest item is shown first.

    51      * @return const RPointerArray< MIAUpdateHistoryItem >& Reference to

    52      * the array that contains update history items.

    53      *

    54      * @since S60 v3.2

    55      */

    56     virtual const RPointerArray< MIAUpdateHistoryItem >& Items() const = 0;

    57 

    58     /**

    59      * Resets and updates the history.

    60      *

    61      * @note History item array is cleared and old items are

    62      * deleted. Then, history is updated with the current items.

    63      * If Items-function has been used to get the array 

    64      * reference, it should be noted that the array content is

    65      * changed.

    66      *

    67      * @since S60 v3.2

    68      */

    69     virtual void RefreshL() = 0; 

    70 

    71     };

    72 

    73 #endif // IA_UPDATE_HISTORY_H