Extended Skins API

最新推荐文章于 2022-11-06 10:35:47 发布

原创最新推荐文章于 2022-11-06 10:35:47 发布 · 807 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#notifications #api #application #header #delete

Symbian 专栏收录该内容

79 篇文章

订阅专栏

本文档介绍了Symbian平台Extended Skins API的基本用法，包括如何连接皮肤服务器、接收皮肤更改通知、获取当前活动主题详情及更换主题等操作，并提供示例代码。

Reviewer Approved

Note!
This API is not part of the public SDK. It can be found in the SDK API Plug-in.

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
#include <AknSSrvClient.h>
#include <AknsPkgID.h>
#include <AknsItemDef.h>
#include <AknsItemID.h>
#include <AknsSrvSkinInformationPkg.h>
#include <EIKENV.H>
#include <centralrepository.h>
#include <AknSkinsInternalCRKeys.h>

Libraries Used
aknskinsrv.lib centralrepository.lib

Capability required
CAPABILITY WriteDeviceData

First connect to the skin server:
void CNotifyEngine::ConstructL()
{
//connect to skin server
User::LeaveIfError( iSkinSrvSession.Connect( this ) );
// to recieve notifications of skin change
iSkinSrvSession.EnableSkinChangeNotify();
}

Virtual functions
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(""));
}
The following code displays current active theme details:
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();
}
The following code changes the active theme:
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();
}
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 );
}
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);
}