net.rim.device.api.system
Interface CoverageStatusListener


public interface CoverageStatusListener

The listener interface for receiving notifications of changes in coverage status, over all supported Wireless Access Families (WAFs), as well as serial bypass and Bluetooth.

The following two conditions must be true before a device is considered to be in sufficient coverage for a connection type:

  1. The device has sufficient radio/serial bypass/Bluetooth coverage for that connection type.
  2. All service book records required for that connection type are routable.

Note that this listener only reports changes in aggregate coverage status, meaning the coverage available over any of the available routes mentioned above. To listen for WAF-specific radio events, use Application.addRadioListener(int,RadioListener). To listen for serial bypass/Bluetooth events, use ServiceRouting.addListener(net.rim.device.api.servicebook.ServiceRoutingListener).

Since:
JDE 4.2.0
See Also:
CoverageInfo

Method Summary
 void coverageStatusChanged(int newCoverage)
          Indicates that the coverage status has changed.
 

Method Detail

coverageStatusChanged

public void coverageStatusChanged(int newCoverage)
Indicates that the coverage status has changed.

Note that a CoverageInfo.COVERAGE_* flag being set in newCoverage is not a guarantee that a connection of that type will succeed. For example, it is possible for the device to lose coverage between the time this notification was fired and a subsequent connection is attempted, or for a destination server to be unresponsive.

Parameters:
newCoverage - The new coverage status, consisting of a bitwise OR of one or more CoverageInfo.COVERAGE_* flags.
Since:
JDE 4.2.0



Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.