PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • 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.
Versions 16 and later
Android This feature is now available for Android applications.
New in version 16
Android This feature is now available for Android applications.
Android This feature is now available for Android applications.
Versions 18 and later
iPhone/iPad This feature is now available for iPhone/iPad applications.
New in version 18
iPhone/iPad This feature is now available for iPhone/iPad applications.
iPhone/iPad This feature is now available for iPhone/iPad applications.
Versions 22 and later
Universal Windows 10 App This feature is now available in Universal Windows 10 App mode.
New in version 22
Universal Windows 10 App This feature is now available in Universal Windows 10 App mode.
Universal Windows 10 App This feature is now available in Universal Windows 10 App mode.
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
Versions 16 and later
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
New in version 16
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.BirthdayDate
Date of birth of contact
Versions 16 and later
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
New in version 16
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.CivilStatusCharacter string.
Gender of contact.
Versions 16 and later
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
New in version 16
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.CompanyCharacter string.
Name of the company where the contact works.
Versions 18 and later
mContact.CreationDate
New in version 18
mContact.CreationDate
mContact.CreationDate
Date
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.
Versions 16 and later
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
New in version 16
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.FirstNameCharacter string.
First name of the contact.
Versions 16 and later
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.
New in version 16
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.
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.
Versions 16 and later
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.).
New in version 16
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.).
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.
Versions 16 and later
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.
New in version 16
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.
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.
Versions 16 and later
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.
New in version 16
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.
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.
Versions 16 and later
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.
New in version 16
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.
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.
Versions 16 and later
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.
New in version 16
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.
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.
Versions 16 and later
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
New in version 16
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
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.
Versions 16 and later
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).
New in version 16
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).
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.
Versions 16 and later
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
New in version 16
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.OfficeAddressCharacter string.
Business address of the contact.
Versions 16 and later
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.).
New in version 16
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.).
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.
Versions 16 and later
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.
New in version 16
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.
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.
Versions 16 and later
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.
New in version 16
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.
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.
Versions 16 and later
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.
New in version 16
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.
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.
Versions 16 and later
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.
New in version 16
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.
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.
Versions 16 and later
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
New in version 16
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
mContact.WebSiteCharacter string.
Address of Internet page of contact.
Versions 16 and later
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
New in version 16
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst This member is ignored.
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