Home · All Classes · Grouped Classes · Annotated · Functions

QSimToolkit Class Reference

The QSimToolkit class provides an interface to SIM toolkit applications. More...

    #include <QSimToolkit>

Inherits QCommInterface.

Inherited by QModemSimToolkit.

• List of all members, including inherited members

Public Functions

• QSimToolkit ( const QString & service = QString(), QObject * parent = 0, QCommInterface::Mode mode = Client )
• ~QSimToolkit ()

• 1 public function inherited from QCommInterface
• 4 public functions inherited from QAbstractIpcInterface
• 37 public functions inherited from QObject

Public Slots

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

• 1 public slot inherited from QObject

Signals

• void beginFailed ()
• void command ( const QSimCommand & command )

• 1 signal inherited from QAbstractIpcInterface
• 1 signal inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 14 protected functions inherited from QAbstractIpcInterface
• 8 protected functions inherited from QObject
• 2 protected variables inherited from QObject
• 1 static protected member inherited from QObject

Detailed Description

The QSimToolkit class provides an interface to SIM toolkit applications.

This class is used by a host program (usually simapp) to access the SIM toolkit facilities defined by 3GPP TS 11.14.

The SIM toolkit application sends a stream of QSimCommand objects to the host program by way of the command() signal. The host program then performs the designated command and responds by calling one of the methods in the QSimToolkit 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 mainMenuSelected() to inform the SIM toolkit of the choice. The SIM toolkit will then send another QSimCommand object for the next phase of the application.

See also QSimCommand and QSimMenuItem.

Member Function Documentation

QSimToolkit::QSimToolkit ( const QString & service = QString(), QObject * parent = 0, QCommInterface::Mode mode = Client )

Construct a new SIM toolkit handling object for service and attach it to parent. The object will be created in client mode if mode is Client, or server mode otherwise.

If service is empty, this class will use the first available service that supports SIM toolkit. If there is more than one service that supports SIM toolkit, the caller should enumerate them with QCommServiceManager::supports() and create separate QSimToolkit objects for each.

See also QCommServiceManager::supports().

QSimToolkit::~QSimToolkit ()

Destroy this SIM toolkit handling object.

void QSimToolkit::aborted ()   [virtual slot]

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

void QSimToolkit::allowCallSetup ()   [virtual slot]

Allow a call setup request to proceed.

Applies to: SetupCall.

See also denyCallSetup().

void QSimToolkit::begin ()   [virtual 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 command() signal with the main menu, or a beginFailed() signal if SIM toolkit facilities are not available.

See also end(), command(), and beginFailed().

void QSimToolkit::beginFailed ()   [signal]

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

void QSimToolkit::cannotProcess ()   [virtual 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 QSimToolkit::clearText ()   [virtual slot]

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

Applies to: DisplayText.

void QSimToolkit::command ( const QSimCommand & command )   [signal]

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

See also QSimCommand.

void QSimToolkit::denyCallSetup ()   [virtual slot]

The user denied a call setup request.

Applies to: SetupCall.

See also allowCallSetup().

void QSimToolkit::end ()   [virtual slot]

End using the SIM toolkit facilities.

See also begin().

void QSimToolkit::endSession ()   [virtual slot]

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

Applies to: GetInkey, GetInput, SetupSubMenu.

void QSimToolkit::help ( QSimCommand::Type command, uint item = 0 )   [virtual slot]

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

Applies to: SetupMainMenu, GetInkey, GetInput, SetupSubMenu.

void QSimToolkit::idleScreen ()   [virtual slot]

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

Applies to: SetupEventList.

See also userActivity().

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

Sends a string value in response to a GetInput command.

Applies to: GetInput.

See also key().

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

Sends a string value in response to a GetInkey command.

Applies to: GetInkey.

See also input().

void QSimToolkit::mainMenuSelected ( uint item )   [virtual slot]

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

Applies to: SetupMainMenu.

void QSimToolkit::moveBackward ()   [virtual slot]

Move backward within the current session.

void QSimToolkit::noResponseFromUser ()   [virtual slot]

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

void QSimToolkit::subMenuExited ()   [virtual slot]

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

Applies to: SetupSubMenu.

See also subMenuSelected().

void QSimToolkit::subMenuSelected ( uint item )   [virtual slot]

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

Applies to: SetupSubMenu.

See also subMenuExited().

void QSimToolkit::temporarilyUnavailable ()   [virtual slot]

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

void QSimToolkit::userActivity ()   [virtual slot]

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

Applies to: SetupEventList.

See also idleScreen().