diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/mw/aknsbasicbackgroundcontrolcontext.h --- a/epoc32/include/mw/aknsbasicbackgroundcontrolcontext.h Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/mw/aknsbasicbackgroundcontrolcontext.h Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,151 @@ -aknsbasicbackgroundcontrolcontext.h +/* +* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members +* which accompanies this distribution, and is available +* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: Defines a public class CAknsBasicBackgroundControlContext. +* +*/ + + +#ifndef AKNSBASICBACKGROUNDCONTROLCONTEXT_H +#define AKNSBASICBACKGROUNDCONTROLCONTEXT_H + +// INCLUDES +#include + +// FORWARD DECLARATIONS +class TAknsBackground; + +// CLASS DECLARATION + +/** +* Implementation of a control context that provides a layout background with +* a background bitmap and its layout rectangle. +* +* This is a public class with exported functions. +* The class is not intended for derivation outside the library. +* +* @lib AknSkins.lib +* +* @since 2.0 +*/ +NONSHARABLE_CLASS(CAknsBasicBackgroundControlContext) : public CBase, + public MAknsControlContext + { + public: // Constructors and destructor + + /** + * Two-phased constructor. + * + * @since 2.0 + * + * @param aImageID Item ID of the background bitmap. + * + * @param aRect Rectangle where the bitmap should be laid out. + * + * @param aParentAbsolute ETrue if parent absolute layout should be + * used, EFalse otherwise. If a parent absolute layout is used, + * the parent position must be set and updated using SetParentPos. + * + * @return Newly constructed object. + */ + IMPORT_C static CAknsBasicBackgroundControlContext* NewL( + const TAknsItemID& aImageID, const TRect& aRect, + TBool aParentAbsolute ); + + /** + * Destructor. + */ + virtual ~CAknsBasicBackgroundControlContext(); + + public: // New functions + + /** + * Sets the item ID of the background bitmap. + * + * @since 2.0 + * + * @param aID Item ID of the bitmap. + */ + IMPORT_C void SetBitmap( const TAknsItemID& aID ); + + /** + * Sets the layout rectangle of the bitmap. + * + * @since 2.0 + * + * @param aRect Rectangle where the bitmap should be laid out. + */ + IMPORT_C void SetRect( const TRect& aRect ); + + /** + * Sets the parent position for the layout. This is only + * used if parent absolute layout was enabled during construction. + * + * @since 2.0 + * + * @param aPos Parent position in screen relative coordinates. + */ + IMPORT_C void SetParentPos( const TPoint& aPos ); + + /** + * Sets the parent context (drawn beneath the context itself). + * No ownership is claimed. The parent context object must be + * valid as long as it is set as parent context. + * + * @since 2.6 + * + * @param aParentContext Pointer to the parent context, or + * @c NULL (default value) if none used. + */ + IMPORT_C void SetParentContext( MAknsControlContext* aParentContext ); + + public: // Functions from MAknsControlContext + + /** + * @copydoc MAknsControlContext::SupplySkinParameter + */ + TInt SupplySkinParameter( TAknsCCParameter aParam ); + + /** + * @copydoc MAknsControlContext::SupplySkinObject + */ + TAny* SupplySkinObject( TAknsCCObject aObject ); + + /** + * @copydoc MAknsControlContext::IsCompatibleWithType + */ + TBool IsCompatibleWithType( const TAknsControlContextType aType ) const; + + protected: + + /** + * C++ constructor. + */ + CAknsBasicBackgroundControlContext(); + + /** + * Symbian 2nd phase constructor. + */ + void ConstructL( const TRect& aRect, TBool aParentAbsolute, + const TAknsItemID& aImageID ); + + protected: // Data + + TAknsBackground* iLayout; //