1 /*

     2 * Copyright (c) 2008 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:  This file contains the header file of the

    15 *              : CSsUiUtilities class.

    16 *

    17 */

    18 

    19 

    20 

    21 #ifndef CSSUIUTILITIES_H

    22 #define CSSUIUTILITIES_H

    23 

    24 // INCLUDES

    25 #include <e32base.h>

    26 #include <bamdesca.h>

    27 #include <gulicon.h>

    28 

    29 // FORWARD DECLARATIONS

    30 class CEikDialog;

    31 class CCoeEnv;

    32 

    33 // CLASS DECLARATION

    34 

    35 /**

    36 *  This class provides UI utilities for service selector

    37 *

    38 *  @lib ServiceSelector.lib

    39 *  @since Series60_5.0

    40 */

    41 NONSHARABLE_CLASS( CSsUiUtilities )

    42         : public CBase

    43     {

    44     public:  // Constructors and destructor

    45       

    46         /**

    47         * Two-phased constructor.

    48         */

    49         static CSsUiUtilities* NewL();

    50         

    51         /**

    52         * Destructor.

    53         */

    54         virtual ~CSsUiUtilities();

    55 

    56     public:

    57 

    58         /**

    59         * Shows a information note.

    60         * @param    aResource Resource id for the note text.

    61         */

    62         void ShowInformationNoteL( TInt aResource );

    63         

    64         /**

    65         * Shows a list query.

    66         * @param    aIndex Index of the selection.

    67         * @param    aResource Resource id for the query.

    68         * @param    aItemTextArray List item array. Ownership

    69         *                          not trasferred.

    70         * @param    aIcons Icon array. Ownership transferred.

    71         * @return   ETrue if list item selected.

    72         */        

    73         TBool ShowListQueryL(

    74                 TInt& aIndex,

    75                 TInt aResource,

    76                 MDesCArray* aItemTextArray,

    77                 CArrayPtr<CGulIcon>* aIcons );

    78         

    79         /**

    80         * Loads default icon for service selection list.

    81         * @param    aIcons Default icon is added to the array.

    82         *                  Icon array takes ownership for 

    83         *                  the added icon.

    84         */        

    85         void LoadDefaultIconL( 

    86                 CArrayPtr<CGulIcon>& aIcons );

    87 

    88     private:

    89         

    90         /**

    91         * Loads resources for the dialogs.

    92         */

    93         void LoadResourceL();

    94         

    95     private:

    96     

    97         /**

    98         * C++ default constructor.

    99         */

   100         CSsUiUtilities();

   101         

   102         /**

   103         * By default Symbian 2nd phase constructor is private.

   104         */

   105         void ConstructL();

   106 

   107     private:    // Data

   108 

   109         // Pointer to current dialog.

   110         CEikDialog* iDlg; 

   111         

   112         // Control environment, not owned

   113         CCoeEnv*    iCoeEnv;

   114         

   115         // Resource file offset

   116         TInt        iResourceFileOffset;

   117                      

   118     };

   119 

   120 #endif      // CSSUIUTILITIES_H

   121             

   122 // End of File