ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / Contact functions (Lotus Notes or Android/iPhone/iPad)
  • Overview
  • Managing the contacts while using the Contact variables
  • Managing the contacts while using the Contact structure (kept for backward compatibility)
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Overview
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:
  1. 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.
  2. 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:
      ContactCreateDisplays the window for contact creation of the native application for contact management found on the device (Android, iPhone or iPad, Universal Windows).
      ContactDisplayOpens the form of a contact in the device's native contacts application (Android, iPhone or iPad, Universal Windows).
      ContactEditOpens the form of a contact in edit mode in the device's native contacts application (Android, iPhone, iPad, Universal Windows).
      ContactSelectDisplays 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:
      ContactAddAdds a contact:
      • in a Lotus Notes or Outlook address book.
      • into the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
      ContactDeleteDeletes 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).
      ContactListSourceLists the sources (or accounts) of the contacts saved on the device.
      ContactModifyModifies the current contact in a Lotus Notes or Outlook address book.
      ContactResetReinitializes:
Related Examples:
WM Managing Contacts 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:
    ContactFirstReads the first contact in a Lotus Notes or Outlook address book.
    ContactLastReads the last contact in a Lotus Notes or Outlook address book.
    ContactNextReads the contact after the current contact in a Lotus Notes or Outlook address book.
    ContactPreviousReads the contact before the current contact in a Lotus Notes or Outlook address book.
    ContactReadReads 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:
    ContactAddAdds a contact:
    • in a Lotus Notes or Outlook address book.
    • into the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
    ContactDeleteDeletes 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).
    ContactDisplayOpens the form of a contact in the device's native contacts application (Android, iPhone or iPad, Universal Windows).
    ContactEditOpens the form of a contact in edit mode in the device's native contacts application (Android, iPhone, iPad, Universal Windows).
    ContactModifyModifies the current contact in a Lotus Notes or Outlook address book.
    ContactReadReads a contact in a Lotus Notes or Outlook address book.
    ContactResetReinitializes:
    ContactSearchSearches for a contact in a Lotus Notes or Outlook address book.
    ContactSelectDisplays the list of contacts found on the device (Android, iPhone or iPad, Universal Windows).
Minimum version required
  • Version 16
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help