Help Center
Local Navigation
- Integrating with BlackBerry Device Software applications
- Message list
- Attachments
- Calendar
- Contact list
- Multiple contact lists support
- Open the contacts application
- Open the contacts application by using contact data
- Open the contacts application with a specific contact list
- Create a contact and assign it to a contact list
- Retrieve contact information
- Retrieve a contact list UID
- Export a contact
- Import a contact
- Delete a contact
- Notify an application when a contact list changes
- Linking third-party contacts with contacts in the contacts application
- Task list
- Phone
- BlackBerry Browser
- Menu items
- Glossary
- Provide feedback
- Document revision history
- Legal notice
BlackBerry Manuals & Help
>
Developer Documentation
>
Java Development Guides and API Reference
>
Development Guide
Integration - BlackBerry Java Application - 5.0
Delete a contact
You can delete a contact from the default contact list or another contact list on a BlackBerry® device.
- Import the required classes and interfaces.
import net.rim.blackberry.api.pdap.BlackBerryContact; import net.rim.blackberry.api.pdap.BlackBerryPIMList; import net.rim.device.api.system.ControlledAccessException; import javax.microedition.pim.Contact; import javax.microedition.pim.ContactList; import javax.microedition.pim.PIM; import javax.microedition.pim.PIMException;
- To delete a contact from the default contact list, invoke PIM.openPIMList(int, int) to open the default contact list instance, passing in as parameters the type of list to open (PIM.CONTACT_LIST), and the access mode with which to open the list (PIM.READ_WRITE, PIM.READ_ONLY, or PIM.WRITE_ONLY). Proceed to step 4.
BlackBerryContactList contactList = (BlackBerryContactList) PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);
- To delete a contact from a contact list that is not the default contact list, perform the following actions:
- Invoke listPIMLists(int pimListType) to return an array of String objects. The returned array provides the system-assigned name for each contact list. The default contact list is returned at index 0 of the array.
String[] lists = PIM.listPIMLists(PIM.CONTACT_LIST);
- Iterate over the array that PIM.listPIMLists() returns to search for the system-assigned name for the contact list that you want to delete.
- Invoke PIM.openPIMList(int, int, String) to open the contact list instance, passing in as parameters the type of list to open (PIM.CONTACT_LIST), the access mode with which to open the list (PIM.READ_WRITE, PIM.READ_ONLY, or PIM.WRITE_ONLY), and the contact list name.
BlackBerryContactList contactList = (BlackBerryContactList) PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE, name);
- Invoke listPIMLists(int pimListType) to return an array of String objects. The returned array provides the system-assigned name for each contact list. The default contact list is returned at index 0 of the array.
- Invoke BlackBerryContactList.removeContact() to delete the contact from the contact list.
contactList.removeContact(contact);
- Check for PIMException, and check for ControlledAccessException if your application does not have permission to access the application that it invokes.
Previous topic: Import a contact