Contacts: 1.1 Setting up a Contact List: Multiple-Selection ContactLists

Recent versions of the ContDB library support ContactLists which allow the user to select more than one contact at a time. This feature is available on devices with version numbers "Responder Build 4...." and higher. See Software Version Number for information about finding out the software version of the user's device.)

To create such a ContactList, give it the hint HINT_CONTACT_LIST_NON_EXCLUSIVE_LIST. The field ATTR_CONTACT_LIST_NUM_ITEMS will then store the number of selected contacts.

There are two methods which may be used to obtain the list of currently selected contacts:

Allocate a buffer to store a list of contacts, and query the ContactList with MSG_CONTACT_LIST_GET_IDS_OF_SELECTED_RECORDS, using the size of this buffer (in bytes) as the input parameter. The message will fill the buffer with the selected ContactListSelectedEntrys.
Set the flag CLF_SELECT_CONTACT_NUMBER in ATTR_GEN_CONTROL_REQUIRE_UI, and set ATTR_CONTACT_LIST_NOTIFY_MULTIPLE_CONTACTS_SELECTED_MSG to the message which will be sent whenever two or more contacts are selected from the contact list. This message must be of the prototype:
```
        @prototype void 
            CONTACT_LIST_NOTIFY_MULTIPLE_CONTACTS_SELECTED_MSG(
				MemHandle block = cx, 
				word num = dx);
```
The passed memory handle block will contain the set of ContactListSelectedEntrys, and num will contain the number of these entries. Your message must free the passed memory block.

GEOS SDK TechDocs |

1 Setting up a Contact List | Next:

1.2 Remembering the Search