ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Communication / Contact functions (Lotus Notes or Android/iPhone/iPad)
  • Overview
  • The different variables of the Contact structure
  • Limitation
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
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
AndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.BirthdayDate
Date of birth of contact
AndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.CivilStatusCharacter string.
Gender of contact.
AndroidiPhone/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
AndroidiPhone/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.
AndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.FirstNameCharacter string.
First name of the contact.
AndroidiPhone/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.
AndroidiPhone/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.
AndroidiPhone/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.
AndroidiPhone/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.
AndroidiPhone/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.
AndroidiPhone/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.
AndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.MobilePhoneCharacter string.
Mobile phone of the contact.
mContact.NameCharacter string.
Name of contact.
AndroidiPhone/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 contact's display name (e.g. Paul Dupont).
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.
AndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.OfficeAddressCharacter string.
Business address of the contact.
AndroidiPhone/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.
AndroidiPhone/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.
AndroidiPhone/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.
AndroidiPhone/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.
AndroidiPhone/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.
AndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.WebSiteCharacter string.
Address of Internet page of contact.
AndroidiPhone/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: 03/27/2025

Send a report | Local help