/*

* Copyright (c) 2003-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:   Declaration of the CCertManUIContainerTrust class

*                Maintains correct list of trusted clients depending

*                on the certificate that was in focus in Authority

*                certificates view when Trust Settings view was entered.

*                Shows and changes correct Yes/No text for the Trusted client.

*

*/

#ifndef  CERTMANUICONTAINERTRUST_H

#define  CERTMANUICONTAINERTRUST_H

// INCLUDES

#include <aknradiobuttonsettingpage.h>

// CONSTANTS

const TInt KTrustSettingsResourceIndexWAP = 0;

const TInt KTrustSettingsResourceIndexMailAndImageConn = 1;

const TInt KTrustSettingsResourceIndexAppCtrl = 2;

const TInt KTrustSettingsResourceIndexJavaInstall = 3;

const TInt KTrustSettingsResourceIndexOCSPCheck = 4;

const TInt KTrustSettingsResourceIndexVPN = 5;

const TInt KTrustSettingsResourceIndexValueYes = 0;

const TInt KTrustSettingsResourceIndexValueNo = 1;

// FORWARD DECLARATIONS

class CCertificateAppInfoManager;

// CLASS DECLARATION

/**

*  CCertManUIContainerTrust container control class.

*

*  @lib certmanui.lib

*/

NONSHARABLE_CLASS( CCertManUIContainerTrust ):

    public CCoeControl, public MCoeControlObserver, public MEikListBoxObserver

    {

    /**

    * Container trust needs to get access to CertManUIViewTrust's DoActivateL

    */

    friend void CCertManUIViewTrust::DoActivateL( const TVwsViewId&, TUid, const TDesC8& );

    public: // functions

        /**

        * Overrided Default constructor

        */

        CCertManUIContainerTrust( CCertManUIViewTrust& aParent, CCertManUIKeeper& aKeeper );

        /**

        * Destructor.

        */

        ~CCertManUIContainerTrust();

        /**

        * Change focus

        */

        void FocusChanged( TDrawNow aDrawNow );

        /**

        * Draws listbox

        */

        void DrawListBoxL( TInt aCurrentPosition, TInt aTopItem, TInt aCertificateIndex );

        /**

        * Puts correct Trust Settings text to listbox and correct value (yes/no) to the setting,

        * asks the value from CheckCertificateClientTrustL

        * For X509 certificates, only one Application is currently supported (Application controller),

        * more applications maybe added later however, so one additional application has been left

        * in comments as an example.

        * WAP connection and Application installer have their names from resources and are thus localized,

        * other additional application get their names from the CertMan API with Name() function

        */

        void UpdateListBoxL( TInt aCertificateIndex );

        /**

        * Handles listbox events

        * Cannot be changed to non-leaving function.

        * L-function is required by the class definition, even if empty.

        */

        void HandleListBoxEventL( CEikListBox* aListBox, TListBoxEvent aEventType );

        /**

        * Changes the Trust Settings text from Yes to No and Vice versa

        * Updates the Trust Settings Listbox item value

        * Can be called only for those certificates that are located in ECrCertLocationCertMan !!!

        * Cannot be called for certificates located in ECrCertLocationWIMCard,

        *                       ECrCertLocationWIMURL,

        *                       ECrCertLocationPhoneMemory

        *                       ECrCertLocationPhoneMemoryURL

        * Certificate formats ECrX968Certificate ECrCertificateURL

        * are not visible in the Trust View

        */

        void UpdateTrustListboxItemL( CCTCertInfo& aEntry, TInt aCurrentTruster );

        /**

        * Puts correct client name and trust state to radiobutton setting page

        * Finds out which client was focused in Trust Settings view and calls ShowTrustChangeSettingPageL

        * This is accessed only by X509 certificates, located in CertMan

        * and having one or more clients

        * Must be public so that viewTrust can access

        */

        void PopupTrustChangeSettingPageL( TInt aCertificateIndex );

        /**

        * Checks if a certificate trusts a client

        * * Certificate format == ECrX509Certificate ECrX968Certificate ECrCertificateURL

        * are not supported if certificate location == ECrCertLocationWIMCard

        * * Certificate format == ECrX968Certificate ECrCertificateURL are not supported

        * if certificate location == ECrCertLocationCertMan

        * * Certificate location == ECrCertLocationWIMURL ECrCertLocationPhoneMemory

        * ECrCertLocationPhoneMemoryURL are not supported

        */

        TBool CheckCertificateClientTrustL( const TUid aClientTUid, CCTCertInfo& aEntry ) const;

        /**

        * Changes the Trust state of client in the CertManAPI

        */

        void ChangeTrustValueL( CCTCertInfo& aEntry, const TUid aClientUid );

        /**

        * Handles resource change

        */

        void HandleResourceChange( TInt aType );

    public: // data

        /**

        * To get hold of ViewTrust

        */

        CCertManUIViewTrust&    iParent;

        /**

        * To get hold of CertManUIKeeper

        */

        CCertManUIKeeper&   iKeeper;

        /**

        * To handle listbox

        * Must be public so that viewTrust can access

        */

        CEikTextListBox*    iListBox;

        /**

        * To get the certificate location

        * Must be public so that viewTrust can access

        */

        TInt  iCertificateLocation;

        /**

        * Application manager class, used to get applications in system.

        */

        CCertificateAppInfoManager*   iAppInfoManager;

        /**

        * Applications registered to system.

        */

        RArray<TCertificateAppInfo> iApps;

        /**

        * Client Uids of the certstore

        */

        RArray<TUid> iClientUids;

    private: // functions

        /**

        * Default constructor

        */

        CCertManUIContainerTrust();

        /**

        * EPOC default constructor.

        * @param aRect Frame rectangle for container.

        */

    void ConstructL(const TRect& aRect);

        /**

        * Creates listbox

        */

        void CreateListBoxL();

        /**

        * From CoeControl,SizeChanged.

        */

        void SizeChanged();

        /**

        * From CoeControl,CountComponentControls.

        */

        TInt CountComponentControls() const;

        /**

        * From CCoeControl,ComponentControl.

        */

        CCoeControl* ComponentControl( TInt aIndex ) const;

        /**

        * From CCoeControl,Draw.

        */

        void Draw( const TRect& aRect ) const;

        /**

        * Handles control events

        * Cannot be changed to non-leaving function.

        * L-function is required by the class definition, even if empty.

        */

        void HandleControlEventL( CCoeControl* aControl,TCoeEvent aEventType);

        /**

        * Handles the key events OK button, arrow keys.

        */

        TKeyResponse OfferKeyEventL( const TKeyEvent& aKeyEvent, TEventCode aType );

        /**

        * Sets empty list for listbox.

        */

        void SetEmptyListL( CEikListBox* aListBox );

        /**

        * Puts correct client names and yes/no state to settings page

        * Sets title text to a setting page

        */

        void ShowTrustChangeSettingPageL( const TUid aClientUid,

            TDesC& aClientName, CCTCertInfo& aEntry );

        void InsertItemToTrustListL( const TInt index, const TUid id,

                                   CCTCertInfo& entry, CDesCArray* itemArray,

                                   TInt position );

        /**

        * Sets empty list for listbox.

        */

        TInt GetTrusterResId( TUid aTrusterUid );

        /**

        * This function is called when Help application is launched.

        * (other items were commented in a header).

        */

        void GetHelpContext( TCoeHelpContext& aContext ) const;

    private: //data

        /**

        * To get the names of the trusted clients from the resources

        */

        CDesCArrayFlat*   iTrustedClients;

        /**

        * To get the yes/no trust texts from the resources

        */

        CDesCArrayFlat*   iTrustValues;

    };

#endif // __CERTMANUICONTAINERTRUST_H

// End of File