diff -r 7d48bed6ce0c -r 987c9837762f satui/satapp/SATUIInc/csatuiiconhandler.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/satui/satapp/SATUIInc/csatuiiconhandler.h Wed Sep 01 12:15:03 2010 +0100 @@ -0,0 +1,112 @@ +/* +* Copyright (c) 2006-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: Introduces CSatUiIconHandler class, which handles +* icon fetching for SatUi. +* +*/ + + +#ifndef CSATUIICONHANDLER_H +#define CSATUIICONHANDLER_H + +#include +#include + +class CFbsBitmap; +class RSatSession; + +/** + * Handles asynchronous icon fetching for SatUi. + * + * Opens connection to SatClient by using received session attribute. + * Receives icon information and does the selection based on received icon id + * attribute. Asks the handle of the icon bitmap from the SatClient's + * RSatIcon class by giving the icon information and the package for handle, + * which is done asynchronously. For mean time, this class is waiting for + * completion of request by starting CActiveSchedulerWait, which is stopped + * when request is completed. After that the icon is duplicated via RSatIcon + * by giving the handle information. This is also an asynchronous call and + * CActiveSchedulerWait is started again. When completed the pointer to the + * bitmap is returned. + * + * @lib satui.exedll + * @since S60 v3.1 + */ +class CSatUiIconHandler : public CBase + { + +public: // Constructors and destructor + + /** + * Constructor. + */ + static CSatUiIconHandler* NewL(); + + /* + * Destructor. + */ + virtual ~CSatUiIconHandler(); + +public: // New functions + + /** + * The method, which fetches the icon. + * + * @since S60 v3.1 + * @param aSatSession Session information for SatClient interface. + * @param aIconId Id for icon to be fetched. + * @param aOptWidth Optimal width of the icon to be fetched. + * @param aOptHeight Optimal height of the icon to be fetched. + * @param aIconSupport Flag to signal if icons are not supported at all + * @return A pointer to the icon bitmap. + */ + CFbsBitmap* FetchIconL( const RSatSession& aSatSession, + const TUint8 aIconId, + const TInt aOptWidth, + const TInt aOptHeight, + TBool& aIconSupport ); + +private: + + /** + * C++ default constructor. + * + * @since S60 v3.1 + */ + CSatUiIconHandler(); + + /** + * Sorts the icons into order of superiority and saves the order into a list + * + * @since S60 v3.1 + * @param aIconEf List of icons + * @param aSelectedIcons List into which order is saved + * @param aOptWidth Optimal width of the icon to be fetched. + * @param aOptHeight Optimal height of the icon to be fetched. + */ + void SortIconsL( const RIconEf& aIconEf, + RArray& aSelectedIcons, + const TInt aOptWidth, + const TInt aOptHeight ) const; + +private: // data + + /** + * RSatService of the SatClient. + */ + RSatService iSatService; + + }; + +#endif // CSATUIICONHANDLER_H