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



#ifndef CSSUIUTILITIES_H
#define CSSUIUTILITIES_H

// INCLUDES
#include <e32base.h>
#include <bamdesca.h>
#include <gulicon.h>

// FORWARD DECLARATIONS
class CEikDialog;
class CCoeEnv;

// CLASS DECLARATION

/**
*  This class provides UI utilities for service selector
*
*  @lib ServiceSelector.lib
*  @since Series60_5.0
*/
NONSHARABLE_CLASS( CSsUiUtilities )
        : public CBase
    {
    public:  // Constructors and destructor
      
        /**
        * Two-phased constructor.
        */
        static CSsUiUtilities* NewL();
        
        /**
        * Destructor.
        */
        virtual ~CSsUiUtilities();

    public:

        /**
        * Shows a information note.
        * @param    aResource Resource id for the note text.
        */
        void ShowInformationNoteL( TInt aResource );
        
        /**
        * Shows a list query.
        * @param    aIndex Index of the selection.
        * @param    aResource Resource id for the query.
        * @param    aItemTextArray List item array. Ownership
        *                          not trasferred.
        * @param    aIcons Icon array. Ownership transferred.
        * @return   ETrue if list item selected.
        */        
        TBool ShowListQueryL(
                TInt& aIndex,
                TInt aResource,
                MDesCArray* aItemTextArray,
                CArrayPtr<CGulIcon>* aIcons );
        
        /**
        * Loads default icon for service selection list.
        * @param    aIcons Default icon is added to the array.
        *                  Icon array takes ownership for 
        *                  the added icon.
        */        
        void LoadDefaultIconL( 
                CArrayPtr<CGulIcon>& aIcons );

    private:
        
        /**
        * Loads resources for the dialogs.
        */
        void LoadResourceL();
        
    private:
    
        /**
        * C++ default constructor.
        */
        CSsUiUtilities();
        
        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();

    private:    // Data

        // Pointer to current dialog.
        CEikDialog* iDlg; 
        
        // Control environment, not owned
        CCoeEnv*    iCoeEnv;
        
        // Resource file offset
        TInt        iResourceFileOffset;
                     
    };

#endif      // CSSUIUTILITIES_H
            
// End of File