CellularRadioInfo

Since: BlackBerry 10.0.0

#include <bb/device/CellularRadioInfo>

To link against this class, add the following line to your .pro file: LIBS += -lbbdevice

Encapsulates the capabilities and state of the cellular radio.

The CellularRadioInfo class provides information about which types of wireless communication standards, voice/data services, and frequencies the radio supports (see technologies(), services(), and bands() respectively). Of the supported wireless communication standards, the user may choose to enable all or a subset using the settings application (see enabledTechnologies()). The user may also use the settings application to turn the radio on and off (see poweredOn()).

The networkCount() and activeTechnologies() methods provide information about how many cellular networks the radio is connected to, and what wireless communication standards they utilize. Additional details about a connected network can be obtained using the CellularNetworkInfo class.


Overview

Properties Index

bb::device::CellularTechnology::TypesactiveTechnologies [read-only]
bb::device::CellularBand::Typesbands [read-only]
booldataEnabled [read-only]
booldataRoaming [read-only]
bb::device::CellularTechnology::TypesenabledTechnologies [read-only]
intnetworkCount [read-only]
boolpoweredOn [read-only]
bb::device::CellularService::Typesservices [read-only]
bb::device::CellularTechnology::Typestechnologies [read-only]

Public Functions Index

CellularRadioInfo (QObject *parent=0)
virtual ~CellularRadioInfo ()
bb::device::CellularTechnology::TypesactiveTechnologies () const
bb::device::CellularBand::Typesbands () const
bb::device::CellularTechnology::TypesenabledTechnologies () const
boolisDataEnabled () const
boolisDataRoaming () const
boolisPoweredOn () const
intnetworkCount () const
bb::device::CellularService::Typesservices () const
bb::device::CellularTechnology::Typestechnologies () const

Signals Index

voidactiveTechnologiesChanged (bb::device::CellularTechnology::Types technologies)
voiddataEnabledChanged (bool dataEnabled)
voiddataRoamingChanged (bool dataRoaming)
voidenabledTechnologiesChanged (bb::device::CellularTechnology::Types technologies)
voidnetworkCountChanged (int networkCount)
voidpoweredOnChanged (bool poweredOn)

Properties

bb::device::CellularTechnology::Types activeTechnologies[read-only]

Bitfield of wireless communication standards that are currently in use.

See also:

bb::device::CellularTechnology::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

bb::device::CellularBand::Types bands[read-only]

Bitfield of frequency bands the radio supports.

See also:

bb::device::CellularBand::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

bool dataEnabled[read-only]

Flag indicating if data services are enabled or disabled.

Since:

BlackBerry 10.2.0

bool dataRoaming[read-only]

Flag indicating if the device is beyond coverage of its home network for data services.

Since:

BlackBerry 10.2.0

bb::device::CellularTechnology::Types enabledTechnologies[read-only]

Bitfield of wireless communication standards that are currently allowed.

See also:

bb::device::CellularTechnology::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

int networkCount[read-only]

Number of connected cellular networks.

Since:

BlackBerry 10.0.0

bool poweredOn[read-only]

Flag indicating whether the radio is turned on or off.

Since:

BlackBerry 10.0.0

bb::device::CellularService::Types services[read-only]

Bitfield of voice/data services the radio supports.

See also:

bb::device::CellularService::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

bb::device::CellularTechnology::Types technologies[read-only]

Bitfield of wireless communication standards the radio supports.

See also:

bb::device::CellularTechnology::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

Public Functions

CellularRadioInfo (

Creates a new CellularRadioInfo object.

Parameters
parent

If not 0, the supplied parent will be responsible for deleting this instance.

Since:

BlackBerry 10.0.0

virtual~CellularRadioInfo ()

Destructor.

Since:

BlackBerry 10.0.0

bb::device::CellularTechnology::Types activeTechnologies ()

Retrieves a bitfield of wireless communication standards that are currently in use.

Return:

Returns a bitfield of wireless communication standards that are currently in use.

See also:

bb::device::CellularTechnology::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

bb::device::CellularBand::Types bands ()

Retrieves a bitfield of frequency bands the radio supports.

Return:

Returns a bitfield of frequency bands the radio supports.

See also:

bb::device::CellularBand::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

bb::device::CellularTechnology::Types enabledTechnologies ()

Retrieves a bitfield of wireless communication standards that are currently allowed.

Return:

Returns a bitfield of wireless communication standards that are currently allowed.

See also:

bb::device::CellularTechnology::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

bool isDataEnabled ()

Indicates whether data services are enabled or disabled.

Return:

Flag indicating if data services are enabled or disabled.

Since:

BlackBerry 10.2.0

bool isDataRoaming ()

Indicates whether the device is beyond coverage of its home network for data services.

Return:

Flag indicating if the device is beyond coverage of its home network for data services.

Since:

BlackBerry 10.2.0

bool isPoweredOn ()

Indicates whether the radio is turned on or off.

Return:

Returns true if the radio is turned on, false otherwise.

Since:

BlackBerry 10.0.0

int networkCount ()

Retrieves the number of connected cellular networks.

Return:

Returns the number of connected cellular networks.

Since:

BlackBerry 10.0.0

bb::device::CellularService::Types services ()

Retrieves a bitfield of voice/data services the radio supports.

Return:

Returns a bitfield of voice/data services the radio supports.

See also:

bb::device::CellularService::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

bb::device::CellularTechnology::Types technologies ()

Retrieves a bitfield of wireless communication standards the radio supports.

Return:

Returns a bitfield of wireless communication standards the radio supports

See also:

bb::device::CellularTechnology::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

Signals

void activeTechnologiesChanged (
  • bb::device::CellularTechnology::Typestechnologies)

Emitted when the active wireless communication standards change.

Parameters
technologies

A bitfield of wireless communication standards that are currently in use.

See also:

bb::device::CellularTechnology::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

void dataEnabledChanged (
  • booldataEnabled)

Emitted when data services become enabled or disabled.

Parameters
dataEnabled

Flag indicating if data services are enabled or disabled.

Since:

BlackBerry 10.2.0

void dataRoamingChanged (
  • booldataRoaming)

Emitted when the roaming indicator for data services changes.

Parameters
dataRoaming

Flag indicating if the device is beyond coverage of its home network for data services.

Since:

BlackBerry 10.2.0

void enabledTechnologiesChanged (
  • bb::device::CellularTechnology::Typestechnologies)

Emitted when the allowed wireless communication standards change.

Parameters
technologies

A bitfield of the new wireless communication standards that are currently allowed.

See also:

bb::device::CellularTechnology::Type for a list of bitfield values.

Since:

BlackBerry 10.0.0

void networkCountChanged (
  • intnetworkCount)

Emitted when the number of connected cellular networks changes.

Parameters
networkCount

The new number of connected cellular networks.

Since:

BlackBerry 10.0.0

void poweredOnChanged (
  • boolpoweredOn)

Emitted when the radio turns on or off.

Parameters
poweredOn

The new power state of the radio.

Since:

BlackBerry 10.0.0

Last modified: 2014-09-29



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus