S60 3rd Edition SDK for Symbian OS
Example Applications Guide

Satellite Info UI Reference Example

1. About this Example
2. Prerequisites
3. What can the Satellite Info UI Reference Application do?
4. User Interface
5. Design and Implementation
6. Summary
7. Class List


1. About this Example

The Satellite Info UI Reference application is a UI application that demonstrates the usage of the CSateliteInfoUI class that is exported by the BLID Application Satellite Info API. This API is used to execute a dialog that displays satellite signal strength information.


2. Prerequisites

This example makes use of the standard Symbian OS application framework comprising of the Application, Document, UI, and View classes. It also makes use of the CSatelliteInfoUI class that is exported by BLID Application Satellite Information API. Please refer to document Series_60_BLID_Application_Satellite_Information_API_Specification for further information about CSatelliteInfoUI API. Satellite Info Reference Application requires “Location” and “SwEvent” capabilities for its operation. The reader should be familiar with all these areas before attempting to understand this example.


3. What can the Satellite Info UI Reference Application do?

The reference application pops a dialog that displays the satellite strengths.


4. User Interface

This section shows how the Satellite Info UI Reference example application is displayed to end-users and explains how to operate it.

4.1 Initial View

When the application has been launched, it will display the default view as shown below. The options menu of the view will have the menu command to launch the Satellite Info dialog. Pressing the Back soft key would close the application.

InitialView.PNG
Figure 1 Initial view

4.2 Launching Satellite Info dialog

To launch the Satellite Info dialog, select the Satellite Status menu item in the Options menu. A progress dialog would display before the satellite dialog displays.

SatInfo.PNG
Figure 2 Launching Satellite Info dialog

4.3 Satellite Info dialog display

After the progress dialog closes, the satellite information dialog as depicted below is displayed. This dialog displays the satellite ID's along with their signal strengths in the form of bars. The satellite with filled bar depicts that the satellite has a fix and the satellite with unfilled bar depicts that it does not have a fix. A maximum of five satellites information is displayed in the decreasing order of their strengths. Pressing the Back soft key closes the dialog and returns to the Initial View.

SatInfoDisplay.PNG
Figure 3 Satellite Info display


5. Design and Implementation

5.1 Design

The class diagram for the Satellite Info UI Reference Application is shown below.

ClassDiagram.PNG
Figure 4 Class Diagram for Satellite Info UI Reference application

5.2 Implementation

The following sequence diagram demonstrates the actions taken when the Satellite Info UI reference application is executed

SeqDiagram.PNG
Figure 5 Sequence diagram for the Satellite Info UI Reference Application describing the application start-up sequence


6. Summary

The Satellite Info UI Reference Application demonstrates as to how the CSatelliteInfoUI class can be used to display the Satellite Strength Information.


7. Class List

This inheritance list is sorted roughly, but not completely, alphabetically:

© Nokia 2006

Back to top