SHOW Signed

net.rim.blackberry.api.pdap
Interface BlackBerryContactList

All Superinterfaces:
ContactList, PIMList

public interface BlackBerryContactList
extends ContactList

Contains the functionality for the BlackBerry-specific implementation of a ContactList.

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 4.0.0

Inner Class Summary
 Category: Signed static interface BlackBerryContactList.AddressTypes
          Describes the various address types supported by the choose(javax.microedition.pim.Contact, int, boolean) method.
 
Fields inherited from interface javax.microedition.pim.PIMList
UNCATEGORIZED
 
Method Summary
 Category: Signed  Contact choose(Contact previous, int type, boolean allowCrossService)
          Launches the address book so that the user can pick an address.
 Category: Signed  void lookup(Contact matching, RemoteLookupListener listener)
          Initiates a remote lookup.
 Category: Signed  void lookup(String matching, RemoteLookupListener listener)
          Initiates a remote lookup.
 
Methods inherited from interface javax.microedition.pim.ContactList
createContact, importContact, removeContact
 
Methods inherited from interface javax.microedition.pim.PIMList
addCategory, close, deleteCategory, getArrayElementLabel, getAttributeLabel, getCategories, getFieldDataType, getFieldLabel, getName, getSupportedArrayElements, getSupportedAttributes, getSupportedFields, isCategory, isSupportedArrayElement, isSupportedAttribute, isSupportedField, items, items, items, itemsByCategory, maxCategories, maxValues, renameCategory, stringArraySize
 

Method Detail

lookup

public void lookup(String matching,
                   RemoteLookupListener listener)
            throws IllegalArgumentException
Initiates a remote lookup.

The results are passed to your provided RemoteLookupListener's items method.

Parameters:
matching - String used for matching fields.
listener - Remote lookup listener.
Throws:
IllegalArgumentException - If you provide a bad parameter.
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.

lookup

public void lookup(Contact matching,
                   RemoteLookupListener listener)
            throws IllegalArgumentException
Initiates a remote lookup.

The results are passed to your provided RemoteLookupListener's items method.

Parameters:
matching - Contact used for matching fields.
listener - Remote lookup listener.
Throws:
IllegalArgumentException - If you provide a bad parameter.
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.

choose

public Contact choose(Contact previous,
                      int type,
                      boolean allowCrossService)
Launches the address book so that the user can pick an address.
Parameters:
previous - Contact used as the starting point in the address book (may be null).
type - One of the address types defined by the BlackBerryContactList.AddressTypes interface.
allowCrossService - If true, permit selection of addresses that will use a different service (ie, BWC etc); otherwise, false.
Returns:
Contact next contact of provided type after provided starting point.
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.