BlackBerryContactList.choose() 메소드를 호출하여 BlackBerry 단말기에서 주소록 프로그램을 열고 특정 연락처 목록을 표시할 수 있습니다.

1. 필요한 클래스와 인터페이스를 가져옵니다.

   import net.rim.blackberry.api.pdap.BlackBerryContact;
   import net.rim.blackberry.api.pdap.BlackBerryContactGroup;
   import net.rim.blackberry.api.pdap.BlackBerryContactList;
   import net.rim.blackberry.api.pdap.BlackBerryPIM;
   import net.rim.blackberry.api.pdap.BlackBerryPIMList;
   import net.rim.device.api.system.ControlledAccessException;
   import javax.microedition.pim.PIM;
   import javax.microedition.pim.PIMException;
   import javax.microedition.pim.PIMItem;

2. PIM.listPIMLists(int pimListType)를 호출하여 String 객체의 배열을 반환받습니다. 반환된 배열은 지정된 형식의 각 PIM 목록별로 하나씩 시스템이 할당한 이름을 제공합니다. 지정된 형식의 기본 목록은 이 배열의 인덱스 0으로 반환됩니다.

   String[] lists = PIM.listPIMLists(PIM.CONTACT_LIST);

3. PIM.listPIMLists()에서 반환된 배열의 모든 요소를 반복하여 표시하려는 연락처 목록에 대해 시스템이 할당한 이름을 찾습니다.
4. BlackBerryPIMList.getPIMListUID()를 호출하여 연락처 목록의 UID를 반환받습니다.

   long uid = cl.getPIMListUID();

5. PIM.getInstance()를 호출하여 PIM 인스턴스를 가져옵니다. 이어서 PIM.openPIMList(int, int, long)를 호출하고, 열려는 목록의 형식(PIM.CONTACT_LIST)과 목록을 열 액세스 모드(PIM.READ_WRITE, PIM.READ_ONLY 또는 PIM.WRITE_ONLY) 및 UID를 매개 변수로 전달하여 연락처 목록을 엽니다.

   BlackBerryContactList list = (BlackBerryContactList) 
       PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE, uid);
   

6. BlackBerryContactList.choose()를 호출하여 BlackBerryContact 또는BlackBerryContactGroup PIMItem을 반환받습니다.

   PIMItem item = list.choose(); 
   if (item instanceof BlackBerryContact)
   {
        BlackBerryContact contact = (BlackBerryContact) item;
        int values = contact.countValues(BlackBerryContact.EMAIL);
        String email = contact.getString(BlackBerryContact.EMAIL, 0);
        System.out.println("Email is: " + email);
   }
   else if (item instanceof BlackBerryContactGroup)
   {
   ...
   }

7. 다른 프로그램을 호출하는 프로그램이 해당 프로그램에 액세스할 수 있는 권한을 갖지 못한 경우 PIMException 및 ControlledAccessException이 발생하는지 확인합니다.