ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / Contact functions (Lotus Notes or Android/iPhone/iPad)
  • Overview
  • The different variables of the Contact structure
  • Limitation
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
The Contact structure is a preset structure of WLanguage (no declaration is required). This structure is used to:
  • create or modify a contact.
  • retrieve the content of a contact.
AndroidiPhone/iPadIOS WidgetMac Catalyst
Warning
From version 17 (69), the Contact structure is kept for backward compatibility to manage contacts on mobile devices. It is recommended to the Contact variable.
The different variables of the Contact structure
The structure contains the following members:
mContact.AnniversaryDate
Anniversary's date of contact
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.BirthdayDate
Date of birth of contact
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.CivilStatusCharacter string.
Gender of contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.CompanyCharacter string.
Name of the company where the contact works.
mContact.CreationDateDate
Creation date of the contact
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.DepartmentCharacter string.
Department where the contact works.
mContact.EmailArray of character strings.
Email address of contact.
To access the different email addresses of the contact, use the following format:
mContact.Email[<Address Num>]
Where <Address Num> corresponds to the number of the requested email address. The number of email addresses for a contact is returned by mContact.NbEmail.
mContact.FirstName2Character string.
Middle name of contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.FirstNameCharacter string.
First name of the contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the name of the contact on the device will be built from the following members: mContact.Name and mContact.FirstName.
  • When reading a contact, this member is not updated.
mContact.HomeAddressCharacter string.
Contact address.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the home address of the contact on the device will be built using the mContact.HomeAddress, mContact.HomeCity, mContact.HomeZipCode, mContact.HomeState and mContact.HomeCountry members.
  • When reading a contact, contains the full home address (Street, City, Zip, etc.).
mContact.HomeCityCharacter string.
Home city of the contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the home address of the contact on the device will be built using the mContact.HomeAddress, mContact.HomeCity, mContact.HomeZipCode, mContact.HomeState and mContact.HomeCountry members.
  • When reading a contact, this member is not updated.
mContact.HomeCountryCharacter string.
Country corresponding to the address of the contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the home address of the contact on the device will be built using the mContact.HomeAddress, mContact.HomeCity, mContact.HomeZipCode, mContact.HomeState and mContact.HomeCountry members.
  • When reading a contact, this member is not updated.
mContact.HomeFaxCharacter string.
Fax number of the contact.
mContact.HomePhoneCharacter string.
Home phone number of the contact.
mContact.HomeStateCharacter string.
Home state of the contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the home address of the contact on the device will be built using the mContact.HomeAddress, mContact.HomeCity, mContact.HomeZipCode, mContact.HomeState and mContact.HomeCountry members.
  • When reading a contact, this member is not updated.
mContact.HomeZipCodeCharacter string.
Zip code for the address of the contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the home address of the contact on the device will be built using the mContact.HomeAddress, mContact.HomeCity, mContact.HomeZipCode, mContact.HomeState and mContact.HomeCountry members.
  • When reading a contact, this member is not updated.
mContact.IDCharacter string.
Unique identifier of contact.
mContact.LastModificationDateDate
Date of last contact modification.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.MobilePhoneCharacter string.
Mobile phone of the contact.
mContact.NameCharacter string.
Name of contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the name of the contact on the device will be built from the following members: mContact.Name and mContact.FirstName.
  • When reading a contact, contains the display name of the contact (for example: Paul Smith).
mContact.NbEmailInteger.
Number of email addresses for the contact.
mContact.NotesCharacter string.
Note attached to a contact and to his address.
mContact.OccupationCharacter string.
Occupation of the contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.OfficeAddressCharacter string.
Business address of the contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the office address of the contact on the device will be built from the mContact.OfficeAddress, mContact.OfficeCity, mContact.OfficeZipCode, mContact.OfficeState and mContact.OfficeCountry members.
  • When reading a contact, contains the full office address (Street, City, Zip, etc.).
mContact.OfficeCityCharacter string.
Business city of the contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the office address of the contact on the device will be built from the mContact.OfficeAddress, mContact.OfficeCity, mContact.OfficeZipCode, mContact.OfficeState and mContact.OfficeCountry members.
  • When reading a contact, this member is not updated.
mContact.OfficeCountryCharacter string.
Country corresponding to the business address of the contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the office address of the contact on the device will be built from the mContact.OfficeAddress, mContact.OfficeCity, mContact.OfficeZipCode, mContact.OfficeState and mContact.OfficeCountry members.
  • When reading a contact, this member is not updated.
mContact.OfficeFaxCharacter string.
Business fax number of the contact.
mContact.OfficeMobilePhoneCharacter string.
Business mobile phone of the contact.
mContact.OfficePagerCharacter string.
Pager number of the contact.
mContact.OfficePhoneCharacter string.
Business phone number of the contact.
mContact.OfficeStateCharacter string.
Business state of the contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the office address of the contact on the device will be built from the mContact.OfficeAddress, mContact.OfficeCity, mContact.OfficeZipCode, mContact.OfficeState and mContact.OfficeCountry members.
  • When reading a contact, this member is not updated.
mContact.OfficeZipCodeCharacter string.
Zip code for the business address of the contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
  • When adding a contact (ContactAdd), the office address of the contact on the device will be built from the mContact.OfficeAddress, mContact.OfficeCity, mContact.OfficeZipCode, mContact.OfficeState and mContact.OfficeCountry members.
  • When reading a contact, this member is not updated.
mContact.OutBoolean.
Indicates whether there is a current contact.
mContact.PrivateBoolean.
Indicates whether the contact is private or not.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.WebSiteCharacter string.
Address of Internet page of contact.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.

Limitation

The Contact structure does not manage an "Other" address (different from the business address and the home address).
Minimum version required
  • Version 11
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 07/03/2023

Send a report | Local help