- Overview
- Managing the contacts while using the Contact variables
- Managing the contacts while using the Contact structure (kept for backward compatibility)
Managing contacts (mobile devices)
In your mobile applications, you have the ability to directly manage the contacts of your mobile device (Android, iPhone, iPad, Universal Windows). To do so, the WLanguage proposes: - the Contact functions.
- the advanced variables of WLanguage: Contact, ...
Remark: For backward compatibility, you also have the ability to use the mContact structure of WLanguage. This solution is not recommended and it should only be used for the applications that operate with a version earlier than Android 2.0.  Versions 18 and later New in version 18Versions 22 and later New in version 22 Managing the contacts while using the Contact variables To manage the contacts found on the mobile device: - Declare a Contact variable. This type of variable is used to describe and find out all the characteristics of the contact found in the mobile device.
- Use the WLanguage functions according to the requested action:
- To read and display in your application the contacts found in the mobile device, use ContactList. This function fills an array of Contact variables. This enables you to browse the array of variables in order to add the different contacts into a looper. For example:
gCurrentContact is Contact
garrContacts is array of Contacts
LooperDeleteAll(LOOP_CONTACTS)
// List of contacts
garrContacts = ContactList()
IF garrContacts..Occurrence > 0 THEN
// Sort the contacts
ArraySort(garrContacts, asMember, "+Name")
// Add into the looper
FOR EACH tContact OF garrContacts
LooperAddLine(LOOP_CONTACTS, ...
tContact..Name, tContact..FirstName)
END
// Display the number of contacts
STC_NbContacts = StringBuild("%1 contacts", ...
garrContacts..Occurrence)
END
- To directly handle the contacts with the native application of the phone, use the following functions:
| | | ContactCreate | Displays the window for contact creation of the native application for contact management found on the device (Android, iPhone or iPad, Universal Windows). | | ContactDisplay | Opens the form of a contact in the native application for contact management of the device (Android, iPhone or iPad, Universal Windows). | | ContactEdit | Opens the form of a current contact in edit mode in the native application for contact management found on the device (Android, iPhone, iPad, Universal Windows). | | ContactSelect | Displays the list of contacts found on the device (Android, iPhone or iPad, Universal Windows). |
- Several WLanguage functions are used to perform all the possible operations:
| | | ContactAdd | Adds a contact: - into the address book of a Lotus Notes or Outlook messaging.
- into the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
| | ContactDelete | Deletes the current contact: - from the address book of a Lotus Notes or Outlook messaging.
- from the list of contacts on the phone (Android, iPhone or iPad, Universal Windows).
| | ContactListSource | Lists the sources (or accounts) of the contacts saved on the device. | | ContactModify | Modifies the current contact in: - the address book of a Lotus Notes or Outlook messaging.
- the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
| | ContactReset | Reinitializes: |
Related Examples:
|
Cross-platform examples (WINDEV Mobile): WM Managing Contacts
[ + ] This example presents the management of contacts for Android et iOS. It is used o: - list the contacts found on the phone - call the contacts - send SMSs to the contacts - ...
|
Managing the contacts while using the Contact structure (kept for backward compatibility)
 Warning
From version 17 (69), this method is kept for backward compatibility. This method is not recommended and it should only be kept for the applications that use a version earlier than Android 2.0.
To manage the contacts of the mobile device, you have the ability to use the mContact structure. This structure is a preset structure of WLanguage used to handle a contact. To handle the contacts found on the mobile device: - Browse the different contacts with the following functions:
| | | ContactFirst | Reads the first contact found in: - the address book of a Lotus Notes or Outlook messaging.
- the list of contacts on the device (Android, iPhone or iPad).
| | ContactLast | Reads the last contact found in: - the address book of a Lotus Notes or Outlook messaging.
- the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
| | ContactNext | Reads the contact found after the current contact in: - the address book of a Lotus Notes or Outlook messaging.
- the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
| | ContactPrevious | Reads the contact found before the current contact in: - the address book of a Lotus Notes or Outlook messaging.
- the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
| | ContactRead | Reads a contact found in: - the address book of a Lotus Notes or Outlook messaging.
- the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
|
The mContact.Out variable is used to find out whether a current record exists. - Handle the current contact with the following functions:
| | | ContactAdd | Adds a contact: - into the address book of a Lotus Notes or Outlook messaging.
- into the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
| | ContactDelete | Deletes the current contact: - from the address book of a Lotus Notes or Outlook messaging.
- from the list of contacts on the phone (Android, iPhone or iPad, Universal Windows).
| | ContactDisplay | Opens the form of a contact in the native application for contact management of the device (Android, iPhone or iPad, Universal Windows). | | ContactEdit | Opens the form of a current contact in edit mode in the native application for contact management found on the device (Android, iPhone, iPad, Universal Windows). | | ContactModify | Modifies the current contact in: - the address book of a Lotus Notes or Outlook messaging.
- the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
| | ContactRead | Reads a contact found in: - the address book of a Lotus Notes or Outlook messaging.
- the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
| | ContactReset | Reinitializes: | | ContactSearch | Finds a contact: - in the address book of a Lotus Notes or Outlook messaging.
- in the list of contacts on the mobile device (Android, iPhone or iPad, Universal Windows).
| | ContactSelect | Displays the list of contacts found on the device (Android, iPhone or iPad, Universal Windows). |
This page is also available for…
|
|
|