View source

{{ReviewerApproved}}
[[Category:Symbian C++]][[Category:S60]][[Category:Code Examples]][[Category:UI]][[Category:Themes]]
__NOEDITSECTION__ __NOTOC__
{{NoteS}}
:This API is not part of the public SDK. It can be found in the [[SDK API Plug-in]]. 
{{NoteE}}
Extended Skins API provides classes to change active, to get skin package information.

== Use cases ==

To change the active theme.

To receive notifications of change in skin content, configuration.

To get skin package information.

To delete skin, copy skin from one location to another.

To set idle wallpaper.

== Example code ==

'''Header files'''
<code cpp>#include <AknSSrvClient.h>
#include <AknsPkgID.h>
#include <AknsItemDef.h>
#include <AknsItemID.h>
#include <AknsSrvSkinInformationPkg.h>
#include <EIKENV.H>
#include <centralrepository.h>
#include <AknSkinsInternalCRKeys.h></code>
<br>'''Libraries Used'''
<code cpp>aknskinsrv.lib centralrepository.lib</code>
<br>'''Capability required'''<code cpp>CAPABILITY WriteDeviceData</code>
<br>'''First connect to the skin server:'''
<code cpp>void CNotifyEngine::ConstructL()
{
//connect to skin server
User::LeaveIfError( iSkinSrvSession.Connect( this ) );
// to recieve notifications of skin change
iSkinSrvSession.EnableSkinChangeNotify();
}</code>
<br>'''Virtual functions'''
<code cpp>void CNotifyEngine::SkinContentChanged()
{
CEikonEnv::Static()->InfoWinL(_L("Skin Content Changed"),_L(""));
}
void CNotifyEngine::SkinConfigurationChanged(const TAknsSkinStatusConfigurationChangeReason aReason )
{ 
CEikonEnv::Static()->InfoWinL(_L("Skin Configuration Changed"),_L(""));
}
void CNotifyEngine::SkinPackageChanged(const TAknsSkinStatusPackageChangeReason aReason)
{
CEikonEnv::Static()->InfoWinL(_L("Skin Package Changed"),_L(""));
}</code>
'''The following code displays current active theme details:'''
<code cpp>void CNotifyEngine::SkinNameL()
{
TAknsPkgIDBuf cidBuf;
CRepository* repository = CRepository::NewLC( KCRUidPersonalisation );
TInt retVal = repository->Get( KPslnActiveSkinUid, cidBuf );
TAknsPkgID cpkgId;
cpkgId.SetFromDesL( cidBuf );
CleanupStack::PopAndDestroy(repository);
CArrayPtr< CAknsSrvSkinInformationPkg >* skinInfoArray = iSkinSrvSession.EnumerateSkinPackagesL();
CleanupStack::PushL( skinInfoArray );
TInt retValue( KErrNone );
if ( skinInfoArray->Count() > 0 )
    {
    for (TInt i=0; i < skinInfoArray->Count(); i++ )
        {
        TAknsPkgID pkgId = skinInfoArray->At(i)->PID();
        if ( pkgId == cpkgId )
            {
            TBuf<128> lBuf = skinInfoArray->At(i)->Name();
            CEikonEnv::Static()->InfoWinL(_L("Skin Name"),lBuf);
            lBuf.Zero();
            lBuf = skinInfoArray->At(i)->FullName();
            CEikonEnv::Static()->InfoWinL(_L("Skin Path"),lBuf);
            lBuf.Zero();
            lBuf = skinInfoArray->At(i)->Directory();
            CEikonEnv::Static()->InfoWinL(_L("Skin Directory"),lBuf);
            lBuf.Zero();
            lBuf = skinInfoArray->At(i)->IniFileDirectory();
            CEikonEnv::Static()->InfoWinL(_L("Skin IniFile Directory"),lBuf);
            break;
            }
        }
    }
skinInfoArray->ResetAndDestroy();
CleanupStack::PopAndDestroy();
}</code>
'''The following code changes the active theme:'''
<code cpp>void CNotifyEngine::ActivateSkinL()
{
StoreCurrentSkinIdL();
CArrayPtr< CAknsSrvSkinInformationPkg >* skinInfoArray = iSkinSrvSession.EnumerateSkinPackagesL();
CleanupStack::PushL( skinInfoArray );
TInt retValue( KErrNone );
if ( skinInfoArray->Count() > 0 )
    {
    for (TInt i=0; i < skinInfoArray->Count(); i++ )
        {
        TAknsPkgID pkgId = skinInfoArray->At(i)->PID();
        if ( pkgId != iOriginalSkinPid )
            {
            TBuf<100> lName = skinInfoArray->At(i)->Name();
            CEikonEnv::Static()->InfoWinL(_L("New Skin Name"),lName);
            //Activate a complete skin package at once.
            retValue = iSkinSrvSession.SetAllDefinitionSets( pkgId );
            if ( retValue == KErrNone )
                {
                SetNewSkinIdL( pkgId );
                }
            break;
            }
        }
    }
skinInfoArray->ResetAndDestroy();
CleanupStack::PopAndDestroy();
}</code><code cpp>void CNotifyEngine::StoreCurrentSkinIdL()
{
TAknsPkgIDBuf pidBuf;
CRepository* repository = CRepository::NewLC( KCRUidPersonalisation );
TInt retVal = repository->Get( KPslnActiveSkinUid, pidBuf );
CleanupStack::PopAndDestroy(repository);
// iOriginalSkinPid is of type TAknsPkgID
iOriginalSkinPid.SetFromDesL( pidBuf );
}</code><code cpp>void CNotifyEngine::SetNewSkinIdL( TAknsPkgID aPkgId )
{
TAknsPkgIDBuf pidBuf;
aPkgId.CopyToDes( pidBuf );
CRepository* repository = CRepository::NewLC( KCRUidPersonalisation );
TInt retVal = repository->Set( KPslnActiveSkinUid, pidBuf );
// KPslnActiveSkinLocation has to be changed also
// if new skin resides on mmc whereas old one resided in phone memory 
CleanupStack::PopAndDestroy(repository);
}</code>
<br>

== Sample application ==

http://wiki.forum.nokia.com/index.php/Image:ExtSkins.zip

=== Related topics ===

* [[How to change the active theme]]