SHOW Signed
 

net.rim.blackberry.api.pdap
Class BlackBerryPIM

java.lang.Object
  |
  +--javax.microedition.pim.PIM
        |
        +--net.rim.blackberry.api.pdap.BlackBerryPIM

public abstract class BlackBerryPIM
extends PIM

Class for accessing the PIM databases on a BlackBerry device.

Contains static methods for performing operations on lists.

For more information about the personal information management (PIM) API, refer to The PDA Profile specification (JSR-000075) for the J2ME(TM) Platform.

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:
JDE 4.2.0
See Also:
PIM, PIMItem, PIMList

Field Summary
 Category: Signed static int MEMO_LIST
          Represents the Memo List type.
 
Fields inherited from class javax.microedition.pim.PIM
CONTACT_LIST, EVENT_LIST, READ_ONLY, READ_WRITE, TODO_LIST, WRITE_ONLY
 
Constructor Summary
 Category: Signed protected BlackBerryPIM()
          BlackBerryPIM objects should be created using the getInstance() method.
 
Method Summary
 Category: Signed  void addListChangeListener(ListChangeListener listener)
          Adds a ListChangeListener to be notified of list change events.
 Category: Signed  void removeListChangeListener(ListChangeListener listener)
          Removes a ListChangeListener from being notified of list change events.
 
Methods inherited from class javax.microedition.pim.PIM
fromSerialFormat, getInstance, listPIMLists, openPIMList, openPIMList, supportedSerialFormats, toSerialFormat
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

MEMO_LIST

public static final int MEMO_LIST
Represents the Memo List type.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Constructor Detail

BlackBerryPIM

protected BlackBerryPIM()
BlackBerryPIM objects should be created using the getInstance() method.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Method Detail

addListChangeListener

public void addListChangeListener(ListChangeListener listener)
Adds a ListChangeListener to be notified of list change events.

If the specified listener is already present in the list of listeners then it will NOT be added again and this method will return as if successful.

The invocations of the methods of the specified listener will occur on the event thread of the calling application. Therefore, if the event thread of the application is no longer alive or is stalled for some other reason then the events will not be delivered. Also, at the time this method is invoked it is required that there be an Application instance returned from Application.getApplication().

Parameters:
listener - the listener to add.
Throws:
NullPointerException - if listener is null.
IllegalStateException - if Application.getApplication() returns null or throws an exception, indicating that the current application is not set.
Since:
JDE 4.7.0
See Also:
removeListChangeListener(ListChangeListener)
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

removeListChangeListener

public void removeListChangeListener(ListChangeListener listener)
Removes a ListChangeListener from being notified of list change events.

If the specified listener is null or is not in the list of listeners then this method does nothing and will return as if successful.

Parameters:
listener - the listener to remove.
Since:
JDE 4.7.0
See Also:
addListChangeListener(ListChangeListener)
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.



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.