S60 Common Date and Time View API Specification: Using Common Date and Time View API

Opening a View

InitCurrentItem function is used to move the current item to the top of the list. See usage example below.

The AddViewL function from Common Date and Time View API can be used for executing the Templates. See usage example of the AddViewL function below.

// Two-phased construction of CClkDateTimeView. 
// aClockUse : ETrue means Clock application uses this API.
// EFalse means any other application than Clock uses it.
// aViewId : Id of a view which is changed when Back softkey is pressed.
// It is ignored when aClockUse is ETrue. return object of CClkDateTimeView.

const TUid KClockAlmViewId = {3};
CClkDateTimeView* dateTimeView = CClkDateTimeView::NewLC(KClockAlmViewId, ETrue);
AddViewL(dateTimeView);
CleanupStack::Pop(dateTimeView);
ActivateLocalViewL(KClkDateTimeViewId);

Error handling

Normal Symbian error handling practises should be used, including e.g. using cleanup stack and trap harness. Leaves and system wide error codes as function return values are used if the error is recoverable. A client application can handle these errors similarly to a normal Symbian platform application.


Copyright © Nokia Corporation 2001-2008
Back to top