Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

API Reference

PhoneLogs

A container to maintain a list of CallLog objects that together represent the call log for phone calls stored in the message list.

Register listeners when interested in receiving call log events. When you subscribe more than one callback function, every new callback set
will overwrite each previous. To unsubscribe from all callbacks, pass null as a parameter.

Supported Platforms

- BlackBerry OS 5.0+

- Ripple Emulator

Parameters

onCallLogAdded

This callback function is triggered when a new call log is added.

addedCallLog: Object that contains the CallLog that was added

onCallLogRemoved

This callback function is triggered when a call log is removed.

removedCallLog: Object that contains the CallLog that was removed

onCallLogUpdated

This callback function is triggered when a call log is updated.

newCallLog: Object that contains the CallLog that represents the new CallLog
oldCallLog: Object that contains the CallLog that represents the old CallLog

optional expression parameter that defines the search criteria for the find. If no value is provided all the Logs are suitable.

folderID

optional 'folderID' parameter specifying the folder where to performed find. If 'folderID' is not supplied the search is made in the missed calls folder (FOLDER_MISSED_CALLS).

orderBy

optional 'orderBy' parameter specifying the field which the results will be sorted by. If 'isAscending' is not supplied or 'isAscending' is true, the sort results will be in an ascending order. If 'isAscending' is false, the sort results will be in a descending order.

maxReturn

optional integer parameter specifying the maximum number of results to return from the find. If not supplied or set to -1, it will return all results found.

isAscending

optional 'isAscending' parameter specifying whether the sort order is ascending or descending. If not supplied or set to true, the results sorted by the field specified by 'orderBy' will be in an ascending order. If set to false, the sort results will be in a descending order. If no 'orderBy' value is specified, 'isAscending' is neglected.