Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

ScShortcuts Engine Wrapper API

From Wiki
Jump to: navigation, search
Article Metadata
Code ExampleArticle
Created: ltomuta (16 Jun 2007)
Last edited: hamishwillee (30 May 2013)

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



This API can be used to change the softkey shortcuts in Active Idle Screen of the S60 3rd Edition phones.

Use cases

To assign shortcut for S60 Calendar application.In the active idle screen we will get left soft key option for launching Calendar

Example code

Header Files


Library : scshortcutenginewrapper.lib

Capabities Required : ReadUserData ReadDeviceData WriteDeviceData

  1. Derive your class from MScShortcutEngineWrapperObserver
  2. Provide implementations for MScShortcutEngineWrapperObserver::HandleShortcutEvent() and MScShortcutEngineWrapperObserver::HandleShortcutError() methods.
  3. Create an object for CScShortcutWrapper
  4. Call AsynchronouslyPrepareShortcutListL(RPointerArray&).If the list gets created successfully then MScShortcutEngineWrapperObserver::HandleShortcutEvent() will be called along with "EShortcutListComplete" event.
  5. Inside MScShortcutEngineWrapperObserver::HandleShortcutEvent() implementation call CScShortcutWrapper::SetShortcutL( ).The index which we pass as argument to the above mentioned API call will decide the application as to which we are creating the shorcut for.
RFs iSession;
CScShortcutEngineWrapper* iShortcut;
RPointerArray<CScWrapperShortcut> iPArray;
//In the ConstructL
//Implementing MScShortcutEngineWrapperObserver::HandleShortcutEvent() method
void CShortCutEngineUsage::HandleShortcutEvent( TScShortcutEvent aEvent )
//note here 1 is the index to denote that we are creating a shortcut for calendar application

Example Project

This page was last modified on 30 May 2013, at 04:40.
47 page views in the last 30 days.