Qtopia Home - Classes - Hierachy - Annotated - Functions - Qt Embedded

SimToolkit Class Reference

A class that provides an interface to SIM toolkit applications. More...

#include <simtoolkit.h>

List of all member functions.

Public Slots

void begin ()
void mainMenuSelected ( uint item )
void clearText ()
void key ( const QString & value )
void input ( const QString & value )
void allowCallSetup ()
void denyCallSetup ()
void subMenuSelected ( uint item )
void subMenuExited ()
void idleScreen ()
void userActivity ()
void endSession ()
void moveBackward ()
void cannotProcess ()
void temporarilyUnavailable ()
void noResponseFromUser ()
void aborted ()
void help ( SimCommand::Type command, uint item = 0 )

Signals

void command ( const SimCommand & command )
void beginFailed ()

Detailed Description

A class that provides an interface to SIM toolkit applications.

This class is used by a host program (usually "simapp") to access the SIM toolkit facilities.

The SIM toolkit application sends a stream of SimCommand objects to the host program by way of the SimToolkit::command signal. The host program then performs the designated command and responds by calling one of the methods in the SimToolkit class.

For example, if the SIM toolkit sends a "SetupMainMenu" command to the host program, the program displays the indicated menu to the user. When the user selects an item, the host program calls SimToolkit::mainMenuSelected to inform the SIM toolkit of the choice. The SIM toolkit will then send another SimCommand object for the next phase of the application.

See also SimCommand, SimMenuItem, and Qtopia Phone Classes.

Member Function Documentation

void SimToolkit::aborted () `[slot]`

Tell the SIM that the current session was aborted by the user. The SIM returns to the main menu.

void SimToolkit::allowCallSetup () `[slot]`

Allow a call setup request to proceed.

Applies to: SetupCall.

void SimToolkit::begin () `[slot]`

Begin using the SIM toolkit facilities and request the main menu.

This is the first method that should be called by a host program that wishes to access the SIM toolkit.

In response, this class will emit a SimToolkit::command signal with the main menu, or a SimToolkit::beginFailed signal if SIM toolkit facilities are not available.

void SimToolkit::beginFailed () `[signal]`

Signal that is emitted if SimToolkit::begin() fails because SIM toolkit functionality was not available.

void SimToolkit::cannotProcess () `[slot]`

Tell the SIM that the previous request was beyond the capability of the ME to perform. i.e. the ME does not have the functionality at all.

void SimToolkit::clearText () `[slot]`

The user has cleared the text display after a "DisplayText" command that did not have "clearAfterDelay()" set.

Applies to: DisplayText.

void SimToolkit::command ( const SimCommand & command ) `[signal]`

Signal that is emitted when the application running in the SIM wishes to send a command to the host program.

void SimToolkit::denyCallSetup () `[slot]`

The user denied a call setup request.

Applies to: SetupCall.

void SimToolkit::endSession () `[slot]`

End the current session, upon the user's request. The SIM returns to the main menu.

Applies to: GetInkey, GetInput, SetupSubMenu.

void SimToolkit::help ( SimCommand::Type command, uint item = 0 ) `[slot]`

Request help for a particular type of command or menu item.

Applies to: SetupMainMenu, GetInkey, GetInput, SetupSubMenu.

void SimToolkit::idleScreen () `[slot]`

Indicate to the SIM toolkit application that the system has become idle and the SIM had previously requested "IdleScreen" events.

Applies to: SetupEventList.

void SimToolkit::input ( const QString & value ) `[slot]`

Send a string in response to a "GetInput" command.

Applies to: GetInput.

void SimToolkit::key ( const QString & value ) `[slot]`

Send a string in response to a "GetInkey" command.

Applies to: GetInkey.

void SimToolkit::mainMenuSelected ( uint item ) `[slot]`

Indicate to the SIM toolkit application that an item on the main menu has been selected.

Applies to: SetupMainMenu.

void SimToolkit::moveBackward () `[slot]`

Move backward within the current session.

void SimToolkit::noResponseFromUser () `[slot]`

Tell the SIM that no response has been received from the user in a reasonable period of time.

void SimToolkit::subMenuExited () `[slot]`

Indicate to the SIM toolkit application that the user has chosen to exit from the current sub menu.

Applies to: SetupSubMenu.

void SimToolkit::subMenuSelected ( uint item ) `[slot]`

Indicate to the SIM toolkit application that an item on a sub menu has been selected.

Applies to: SetupSubMenu.

void SimToolkit::temporarilyUnavailable () `[slot]`

Tell the SIM that the ME cannot process the previous request at this time, but may be able to later.

void SimToolkit::userActivity () `[slot]`

Indicate to the SIM toolkit application that user activity has occurred and the SIM had previously requested "UserActivity" events.

Applies to: SetupEventList.

Trademarks

Qtopia version 2.1.2

SimToolkit Class Reference

Public Slots

Signals

Detailed Description

Member Function Documentation

void SimToolkit::aborted () [slot]

void SimToolkit::allowCallSetup () [slot]

void SimToolkit::begin () [slot]

void SimToolkit::beginFailed () [signal]

void SimToolkit::cannotProcess () [slot]

void SimToolkit::clearText () [slot]

void SimToolkit::command ( const SimCommand & command ) [signal]

void SimToolkit::denyCallSetup () [slot]

void SimToolkit::endSession () [slot]

void SimToolkit::help ( SimCommand::Type command, uint item = 0 ) [slot]

void SimToolkit::idleScreen () [slot]

void SimToolkit::input ( const QString & value ) [slot]

void SimToolkit::key ( const QString & value ) [slot]

void SimToolkit::mainMenuSelected ( uint item ) [slot]

void SimToolkit::moveBackward () [slot]

void SimToolkit::noResponseFromUser () [slot]

void SimToolkit::subMenuExited () [slot]

void SimToolkit::subMenuSelected ( uint item ) [slot]

void SimToolkit::temporarilyUnavailable () [slot]

void SimToolkit::userActivity () [slot]