/*

* Copyright (c) 2005 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:  Utility class for info view dialog.

*

*/

#ifndef PBKINFOVIEWDIALOGUTIL_H

#define PBKINFOVIEWDIALOGUTIL_H

//  INCLUDES

#include <e32base.h>

#include <akntabgrp.h>      // for AknTextUtils

#include <aknlistquerycontrol.h>

#include <AknQueryDialog.h>

#include <AknsUtils.h>      // for AknsUtils

// CONSTANTS

const TInt KBufSize = 128;

/**

* TDialogUtil

* 

* TDialogUtil contains general dialog utilities.

*/

NONSHARABLE_CLASS ( TDialogUtil )

	{

    public:

        /**

		* Constructs a list-box item for CAknDoubleLargeStyleListBox.

		* @param aFirstLine First line of the dialog item

        * @param aSecondLine Second line of the dialog item

        * @param aIconIndex Icon index

        * @return HBufC* Pointer to the newly created list box item.

		*/

        static HBufC* ConstructListBoxItemLC( const TDesC& aFirstLine,

                                              const TDesC& aSecondLine,

                                              TInt aIconIndex );

        /**

		* Constructs an independent CGulIcon object with fallback support.

		* If no matching item (aId) is found in the currently active skin,

		* attempts to construct the item using the given file (last 3 parameters).

		* @param aID Item ID of the masked bitmap to be created.

        * @param aFilename Filename to be used to construct the item, 

        * @param aFileBitmapId Id (for bitmap) in the file. 

        * @param aFileMaskId Id (for mask) in the file.

        * @return CGulIcon* Pointer to the newly created CGulIcon object.

        *         Ownership of the object is transferred to the caller.

		*/

		static CGulIcon* CreateIconL( TAknsItemID aId, const TDesC& aFileName,

		                              TInt aFileBitmapId, TInt aFileMaskId);

	};

/**

* CStatusPaneHandler

* 

* This class is used for changing dialog title and image.

*/

NONSHARABLE_CLASS (CStatusPaneHandler) : public CBase

	{

    public:

        /**

        * Two-phased constructor.

        */

		static CStatusPaneHandler* NewL(CAknAppUi* aAppUi);

        /**

        * Destructor.

        */

		virtual ~CStatusPaneHandler();

    private:

        /**

        * By default Symbian OS constructor is private.

        */

		void ConstructL();

        /**

        * C++ default constructor.

        */

		CStatusPaneHandler(CAknAppUi* aAppUi);

	public:

	    /**

		* Sets the member variable for previous title.

		* @param  None.

		* @return None.

		*/

        void StoreOriginalTitleL();

        /**

		* Sets the dialog title.

		* @param aResourceId Resource id from resource file.

		* @return None.

		*/

		void SetTitleL( TInt aResourceId );

		/**

		* Restores previous title when returning to previous view.

		* @param  None.

		* @return None.

		*/

		void RestorePreviousTitleL();

     private:	

		/**

		* Gets the dialog title.

		* @param aAppUi Pointer to UI class.

		* @param aText Title will be put to this variable.

		* @return TBool ETrue: success / EFalse: failure.

		*/

		static TBool GetPreviousTitleL( CAknAppUi* aAppUi, TDes& aText );

		/**

		* Restores previous title image when returning to previous view.

		* @param  None.

		* @return None.

		*/

		void RestoreOriginalImageL();

		/**

		* Sets dialog image.

		* @param aAppUi Pointer to UI class.

		* @param aIcon New image .

		* @return CEikImage* previous image.

		*/

		static CEikImage* SetImageL( CAknAppUi* aAppUi, CEikImage* aIcon );

		/**

		* Sets the dialog title.

		* @param aAppUi Pointer to the UI class.

		* @param aText TItle text.

		*/

		void static SetTitleL( CAknAppUi* aAppUi, const TDesC& aText );

	private:

		// Access to app ui

		CAknAppUi* iAppUi;

		// Original status pane title

		TBuf<KBufSize> iOriginalTitle;

		// Is original status pane title stored

		TBool iOriginalTitleStored;

		// Original context pane image

		CEikImage* iOriginalImage;

	};

#endif      // PBKINFOVIEWDIALOGUTIL_H

// End of File