Join Now
Quality Rating:
  • Currently 0.0 / 5
(0.0 / 5 - 0 votes cast)
Expertise Level:
  • Currently 0.0 / 5
(0.0 / 5 - 0 votes cast)

This page was last modified 18:57, 24 June 2008.

ScShortcuts Engine Wrapper API

From Forum Nokia Wiki

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

Example_Application

Related Discussions
Thread Thread Starter Forum Replies Last Post
need some help in porting games on openC infinus Open C 9 2008-07-07 12:41
can v find signal strength in bluetooth?? mostwantedaustin Symbian Networking & Messaging 1 2008-02-19 11:12
how to check this.....becoz emulator dosent have "My Folder" option bharats General Symbian C++ 8 2006-11-27 13:14
vCalendar Sync Problem about extended field andrew_lin General Symbian C++ 1 2008-01-04 16:22
How to call methods of JSR179 from C++ code anand_zain76 General Symbian C++ 1 2006-08-10 14:10
 
Powered by MediaWiki
     
     RDF Facets:
     
     
     qfnZtopicQUqfnTopicZseriesE5f60Q
     qfnZtypeQUqfnTypeZCommunityContentQ
     qfnZtypeQUqfnTypeZWebpageQ
     qfnZtypeQUqfnTypeZWikiContentQ
     qmarsZlanguageQUxhttpE3aE2fE2fswE2enokiaE2ecomE2flanguageE2d1E2fenX