- 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, WLanguage provides you with: - 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.
Managing the contacts while using the Contact variables To manage the contacts found on the mobile device: - Declare a variable of type Contact. 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 Contact
LooperDeleteAll(LOOP_CONTACTS)
// List of contacts
garrContacts = ContactList()
IF garrContacts.Count > 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.Count)
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 device's native contacts application (Android, iPhone or iPad, Universal Windows). | | ContactEdit | Opens the form of a contact in edit mode in the device's native contacts application (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: - in a Lotus Notes or Outlook address book.
- into the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
| | ContactDelete | Deletes the current contact: - from a Lotus Notes or Outlook address book.
- 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 a Lotus Notes or Outlook address book. | | 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 in a Lotus Notes or Outlook address book. | | ContactLast | Reads the last contact in a Lotus Notes or Outlook address book. | | ContactNext | Reads the contact after the current contact in a Lotus Notes or Outlook address book. | | ContactPrevious | Reads the contact before the current contact in a Lotus Notes or Outlook address book. | | ContactRead | Reads a contact in a Lotus Notes or Outlook address book. |
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: - in a Lotus Notes or Outlook address book.
- into the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
| | ContactDelete | Deletes the current contact: - from a Lotus Notes or Outlook address book.
- from the list of contacts on the phone (Android, iPhone or iPad, Universal Windows).
| | ContactDisplay | Opens the form of a contact in the device's native contacts application (Android, iPhone or iPad, Universal Windows). | | ContactEdit | Opens the form of a contact in edit mode in the device's native contacts application (Android, iPhone, iPad, Universal Windows). | | ContactModify | Modifies the current contact in a Lotus Notes or Outlook address book. | | ContactRead | Reads a contact in a Lotus Notes or Outlook address book. | | ContactReset | Reinitializes: | | ContactSearch | Searches for a contact in a Lotus Notes or Outlook address book. | | ContactSelect | Displays the list of contacts found on the device (Android, iPhone or iPad, Universal Windows). |
This page is also available for…
|
|
|
|