Suporte a várias listas de contatos

O suporte a várias listas de contatos está disponível no BlackBerry Java Development Environment 5.0 ou posterior. Cada lista de contatos tem um nome de lista de contatos atribuído pelo sistema e uma UID que você pode usar para recuperar a lista. Você pode alterar o nome da lista de contatos usando o BlackBerry Desktop Manager para alterar o nome do serviço associado ao nome da lista de contatos. Não é possível alterar a UID.

Ao decidir como você deseja abrir uma lista de contatos, considere a persistência no aparelho BlackBerry. Se seu aplicativo exige o nome da lista de contatos para persistir após atualizações do sistema operacional, use a UID para abrir a lista de contatos. Se seu aplicativo exige o nome da lista de contatos apenas para persistir após reinicializações do aparelho BlackBerry, você poderá usar o nome da lista de contatos. Como o nome da lista de contatos pode ser alterado, você pode registrar um ouvinte de eventos de alteração de nome invocando BlackBerryPIM.addListChangeListener(ListChangeListener listener).

Você pode recuperar os nomes das listas de contatos instaladas em um aparelho BlackBerry ao executar PIM.listPIMLists(int pimListType) e passar PIM.CONTACT_LIST como pimListType. A matriz String retornada fornece os nomes atribuídos pelo sistema às listas de contatos no aparelho. O nome da lista de contatos que está no índice 0 da matriz String retornada é a lista de contatos padrão. Você pode recuperar a UID de uma lista de contatos em um aparelho BlackBerry executando BlackBerryPIMList.getPIMListUID().

Você pode abrir uma lista de contatos pelo seu nome invocando PIM.openPIMList(int pimListType, int mode, String name). Você pode abrir uma lista de contatos pela sua UID invocando BlackBerryPIM.openPIMList(int pimListType, int mode, long uid). Você pode abrir uma lista que combine várias listas de contatos em um aparelho executando um dos métodos BlackBerryPIM.openUnifiedPIMList().

Tópico anterior: Lista de contatos

Estas informações foram úteis? Gostaríamos de receber seus comentários.