SHOW Signed

net.rim.device.api.system
Interface PeripheralListener


public interface PeripheralListener

The listener interface for receiving peripheral events.

Peripherals, such as the travel charger, are used to extend the functionality of the BlackBerry.

Note this API is only supported on 857/957 and 5810/5820 handhelds.

Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Since:
JDE 3.6.0

Field Summary
 Category: Signed static int TYPE_CAR_CHARGER
          Indicates that the RIM car charger peripheral is attached to the device.
 Category: Signed static int TYPE_CRADLE
          Indicates that device is attached to the cradle.
 Category: Signed static int TYPE_NONE
          Indicates that no peripheral is found.
 Category: Signed static int TYPE_TRAVEL_CHARGER
          Indicates that the RIM travel charger peripheral is attached to the device.
 Category: Signed static int TYPE_UNKNOWN
          Indicates that the attached peripheral is of an unknown type.
 Category: Signed static int TYPE_USER
          Indicates that a recognized third party peripheral is attached to the device.
 
Method Summary
 Category: Signed  void peripheralChange(int type)
          Invoked when the state of the peripheral port changes.
 

Field Detail

TYPE_UNKNOWN

public static final int TYPE_UNKNOWN
Indicates that the attached peripheral is of an unknown type.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

TYPE_USER

public static final int TYPE_USER
Indicates that a recognized third party peripheral is attached to the device.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

TYPE_CAR_CHARGER

public static final int TYPE_CAR_CHARGER
Indicates that the RIM car charger peripheral is attached to the device.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

TYPE_CRADLE

public static final int TYPE_CRADLE
Indicates that device is attached to the cradle.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

TYPE_NONE

public static final int TYPE_NONE
Indicates that no peripheral is found.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

TYPE_TRAVEL_CHARGER

public static final int TYPE_TRAVEL_CHARGER
Indicates that the RIM travel charger peripheral is attached to the device.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Method Detail

peripheralChange

public void peripheralChange(int type)
Invoked when the state of the peripheral port changes.

Parameters:
type - Current type of peripheral attached to the device, or TYPE_NONE if no peripheral is currently attached. Any one of the above values are valid.
Since:
JDE 4.0.2
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.


Copyright 1999-2004 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.