PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Principle of the modification by using the Contact structure
  • Notes
  • Required application feature
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Modifies the current contact in:
  • WINDEVWEBDEV - Server codeReports and Queries the address book of a Lotus Notes or Outlook messaging.
    Caution: This function cannot be used to read the last contact found in the address book of an Outlook Express messaging.
  • Versions 16 and later
    AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
    New in version 16
    AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
    AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App the list of contacts on the device (Android, iPhone or iPad, Universal Windows).
Versions 16 and later
Android This function is now available for the Android applications.
New in version 16
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
Versions 18 and later
Android Widget This function is now available in Android Widget mode.
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 18
Android Widget This function is now available in Android Widget mode.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Android Widget This function is now available in Android Widget mode.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 22 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 22
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Example
WINDEVWEBDEV - Server codeReports and QueriesAjaxUser code (UMC)
// Start a Lotus Notes session
SessionID is int
SessionID = EmailStartNotesSession("Password", "MarsServer", ...
"email/julia.nsf", "C:\Lotus Notes\julia.id")
// Find the contact to modify
IF ContactSearch(SessionID, "Smith", mContactLastName, "Adriana", mContactFirstName) = True THEN
// Modify the phone number of the contact
mContact.MobilePhone = "06.15.14.84.52"
ContactModify(SessionID)
Info("The phone number was modified")
ELSE
Info("No contact was found")
END
Syntax
WINDEVWEBDEV - Server codeReports and QueriesAjaxUser code (UMC)

Modifying the current contact in the Lotus Notes or Outlook messaging Hide the details

<Result> = ContactModify(<Session Identifier>)
<Result>: Boolean
  • True if the modification was performed.
  • False otherwise. To find out the error details, use ErrorInfo associated with the errMessage constant.
<Session Identifier>: Integer
Identifier of session to use. This identifier is returned by one of the following functions: EmailStartNotesSession, EmailStartOutlookSession, NotesOpenDatabase or OutlookStartSession.
Versions 17 and later
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App Caution: Syntax available from version 170069

Modifying the current contact in the list of contacts on the device (Android 2.0 and later, iPhone ou iPad, Universal Windows) Hide the details

<Result> = ContactModify(<Contact>)
<Result>: Boolean
  • True if the modification was performed,
  • False otherwise. To find out the error details, use ErrorInfo associated with the errMessage constant.
<Contact>: Contact variable
Name of the Contact variable corresponding to the contact for which the modified information must be updated.
New in version 17
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App Caution: Syntax available from version 170069

Modifying the current contact in the list of contacts on the device (Android 2.0 and later, iPhone ou iPad, Universal Windows) Hide the details

<Result> = ContactModify(<Contact>)
<Result>: Boolean
  • True if the modification was performed,
  • False otherwise. To find out the error details, use ErrorInfo associated with the errMessage constant.
<Contact>: Contact variable
Name of the Contact variable corresponding to the contact for which the modified information must be updated.
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App Caution: Syntax available from version 170069

Modifying the current contact in the list of contacts on the device (Android 2.0 and later, iPhone ou iPad, Universal Windows) Hide the details

<Result> = ContactModify(<Contact>)
<Result>: Boolean
  • True if the modification was performed,
  • False otherwise. To find out the error details, use ErrorInfo associated with the errMessage constant.
<Contact>: Contact variable
Name of the Contact variable corresponding to the contact for which the modified information must be updated.
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App
Versions 16 and later
Warning
From version 17 (69), this syntax is kept for backward compatibility.
New in version 16
Warning
From version 17 (69), this syntax is kept for backward compatibility.
Warning
From version 17 (69), this syntax is kept for backward compatibility.

Modifying the current contact in the list of contacts on the device (before Android 2.0, iPhone ou iPad, Universal Windows) Hide the details

<Result> = ContactModify(<Type of Contact>)
<Result>: Boolean
  • True if the modification was performed,
  • False otherwise. To find out the error details, use ErrorInfo associated with the errMessage constant.
<Type of Contact>: Integer constant
Type of contact to modify. By default, this parameter corresponds to the contactPhone constant.
Remarks

Principle of the modification by using the Contact structure

When reading a contact (with ContactRead, ContactFirst, ContactLast, ...), the data of this contact is updated in the Contact structure.
To modify the current contact, you must:
  1. Modify the values of the Contact structure.
  2. Validate the modifications with ContactModify.
Versions 16 and later
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App

Notes

  • To display the window for contact creation of the native application for managing the device contacts, use ContactCreate.
  • Syntax that is using the Contact structure (before Android 2.0): Only the following members of the Contact structure will be taken into account when modifying the contact:
    • mContact.Name
      The name of the contact on the device will be built from the mContact.Name and mContact.FirstName members.
    • mContact.FirstName
      The name of the contact on the device will be built from the mContact.Name and mContact.FirstName members.
    • mContact.Notes
    • mContact.HomeAddress
      The home address of the contact on the device will be built from the mContact.HomeAddress, mContact.HomeCity, mContact.HomeZip, mContact.HomeState and mContact.HomeCountry members.
    • mContact.HomeCity
    • mContact.HomeZipCode
    • mContact.HomeState
    • mContact.HomeCountry
    • mContact.HomePhone
    • mContact.HomeFax
    • mContact.MobilePhone
    • mContact.Company
    • mContact.Department
    • mContact.OfficeAddress
      The business address of the contact on the device will be built from the mContact.OfficeAddress, mContact.OfficeCity, mContact.OfficeZip, mContact.OfficeState and mContact.OfficeCountry members.
    • mContact.OfficeCity
    • mContact.OfficeZipCode
    • mContact.OfficeState
    • mContact.OfficeCountry
    • mContact.OfficePhone
    • mContact.OfficeFax
    • mContact.OfficeMobilePhone
    • mContact.OfficePager
    • mContact.Email
New in version 16
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App

Notes

  • To display the window for contact creation of the native application for managing the device contacts, use ContactCreate.
  • Syntax that is using the Contact structure (before Android 2.0): Only the following members of the Contact structure will be taken into account when modifying the contact:
    • mContact.Name
      The name of the contact on the device will be built from the mContact.Name and mContact.FirstName members.
    • mContact.FirstName
      The name of the contact on the device will be built from the mContact.Name and mContact.FirstName members.
    • mContact.Notes
    • mContact.HomeAddress
      The home address of the contact on the device will be built from the mContact.HomeAddress, mContact.HomeCity, mContact.HomeZip, mContact.HomeState and mContact.HomeCountry members.
    • mContact.HomeCity
    • mContact.HomeZipCode
    • mContact.HomeState
    • mContact.HomeCountry
    • mContact.HomePhone
    • mContact.HomeFax
    • mContact.MobilePhone
    • mContact.Company
    • mContact.Department
    • mContact.OfficeAddress
      The business address of the contact on the device will be built from the mContact.OfficeAddress, mContact.OfficeCity, mContact.OfficeZip, mContact.OfficeState and mContact.OfficeCountry members.
    • mContact.OfficeCity
    • mContact.OfficeZipCode
    • mContact.OfficeState
    • mContact.OfficeCountry
    • mContact.OfficePhone
    • mContact.OfficeFax
    • mContact.OfficeMobilePhone
    • mContact.OfficePager
    • mContact.Email
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App

Notes

  • To display the window for contact creation of the native application for managing the device contacts, use ContactCreate.
  • Syntax that is using the Contact structure (before Android 2.0): Only the following members of the Contact structure will be taken into account when modifying the contact:
    • mContact.Name
      The name of the contact on the device will be built from the mContact.Name and mContact.FirstName members.
    • mContact.FirstName
      The name of the contact on the device will be built from the mContact.Name and mContact.FirstName members.
    • mContact.Notes
    • mContact.HomeAddress
      The home address of the contact on the device will be built from the mContact.HomeAddress, mContact.HomeCity, mContact.HomeZip, mContact.HomeState and mContact.HomeCountry members.
    • mContact.HomeCity
    • mContact.HomeZipCode
    • mContact.HomeState
    • mContact.HomeCountry
    • mContact.HomePhone
    • mContact.HomeFax
    • mContact.MobilePhone
    • mContact.Company
    • mContact.Department
    • mContact.OfficeAddress
      The business address of the contact on the device will be built from the mContact.OfficeAddress, mContact.OfficeCity, mContact.OfficeZip, mContact.OfficeState and mContact.OfficeCountry members.
    • mContact.OfficeCity
    • mContact.OfficeZipCode
    • mContact.OfficeState
    • mContact.OfficeCountry
    • mContact.OfficePhone
    • mContact.OfficeFax
    • mContact.OfficeMobilePhone
    • mContact.OfficePager
    • mContact.Email
Versions 22 and later
Universal Windows 10 App

Required application feature

The use of this function triggers the declaration of an application feature in the wizard for generating the application.
Required feature: Contacts
This feature allows the applications to access the contacts.
New in version 22
Universal Windows 10 App

Required application feature

The use of this function triggers the declaration of an application feature in the wizard for generating the application.
Required feature: Contacts
This feature allows the applications to access the contacts.
Universal Windows 10 App

Required application feature

The use of this function triggers the declaration of an application feature in the wizard for generating the application.
Required feature: Contacts
This feature allows the applications to access the contacts.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230com.dll
Android wd230android.jar
Minimum required version
  • Version 11
This page is also available for…
Comments
Click [Add] to post a comment