ScShortcuts Engine Wrapper API

Comments

There is something missing in the given example: the call to CScShortcutEngineWrapper::NewL fails with error -46 (permission denied) if the right capabilities is not specified in the elf2e32.exe (post linker) command. The capabilities are ReadDeviceData WriteDeviceData, meaning that you need a certificate in order to use this API

Capability missing in the example project

A few comments here:

• A quick check shows that the example application's MMP file has in its capability statement the capabilities that you say are missing.

CAPABILITY ReadDeviceData WriteDeviceData ReadUserData

• The entire point of having a wiki is that content can be altered as needed, when needed, by those who have discovered the need. Please do jump in and make the appropriate corrections with the motto "Better to say Sorry! than to wait for someone's permission". Those interested in monitoring the changes should watch the pages and fight back for their own truth when appropriate. :)

ltomuta 13:40, 25 September 2007 (UTC)

Fails on N95 device

Hi,

I tried to build an example using ScShortcutsEngineWrapper API for N95 device.

Below statement gives out "System Error!" alert note on the device:

"iShortcut=CScShortcutEngineWrapper::NewL(iSession,*this);"

But initializing "CScWrapperShortcut" object does not give any error!

May I request for insights on this issue!

Thanks!

Log in or Join to leave comments.

Article Metadata

---

Code Example

Source file: Media:ShortCutExample.zip

---

Article

Created: ltomuta (16 Jun 2007)

Last edited: hamishwillee (26 Jul 2012)

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

APIPurpose

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

#include<MScShortcutEngineWrapperObserver.h>
#include<cscshortcutenginewrapper.h>

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
iSession.Connect();
iShortcut=CScShortcutEngineWrapper::NewL(iSession,*this);
iShortcut->AsynchronouslyPrepareShortcutListL(iPArray);
//Implementing MScShortcutEngineWrapperObserver::HandleShortcutEvent() method
void CShortCutEngineUsage::HandleShortcutEvent( TScShortcutEvent aEvent )
{
if(aEvent==EShortcutListComplete)
{
//note here 1 is the index to denote that we are creating a shortcut for calendar application
iShortcut->SetShorcutL(CScShortcutEngineWrapper::EKeyTypeLeft,1)
}
 
}

Example Project

File:ShortCutExample.zip