ContactEdit (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Special cases
Required application feature

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ContactEdit (Function)

In french: ContactEdite

Opens the form of a current contact in edit mode in the native application for contact management found on the device (Android, iPhone, iPad, Universal Windows).

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available for the iPhone/iPad applications.

New in version 18

This function is now available in Android Widget mode.

This function is now available for the iPhone/iPad applications.

This function is now available in Android Widget mode.

This function is now available for the iPhone/iPad applications.

Versions 22 and later

This function is now available in Universal Windows 10 App mode.

New in version 22

This function is now available in Universal Windows 10 App mode.

Example

// Open the current contact's form in edit mode
// Global variables
gCurrentContact is Contact

...

// - Click on BTN_Modify
// Starts editing the contact
ContactEdit(gCurrentContact)

// Opens in edit the form of the first contact found on the phone
// Syntax kept for backward compatibility
IF ContactFirst(contactPhone) = True THEN
IF ContactEdit() = True THEN
// If the contact was modified, updates the contact structure
// with the new contact's data
ContactRead(contactPhone, mContact.ID)
END
END

Syntax

Versions 17 and later

Caution: Syntax available from version 170069

Opening the form of a contact in edit mode (from Android 2.0, iPhone, iPad, Universal Windows) Hide the details

<Result> = ContactEdit(<Contact>)

<Result>: Boolean

True if the contact was modified,
False otherwise. The ErrorOccurred variable is set to True if an error occurred. To find out the error details, use ErrorInfo.
Versions 22 and later

True if the user interface is displayed,
False otherwise.
New in version 22

True if the user interface is displayed,
False otherwise.

True if the user interface is displayed,
False otherwise.

<Contact>: Contact variable

Name of Contact variable corresponding to the contact whose form will be opened. This contact must exist in the database of contacts found on the device.

New in version 17

Caution: Syntax available from version 170069

Opening the form of a contact in edit mode (from Android 2.0, iPhone, iPad, Universal Windows) Hide the details

<Result> = ContactEdit(<Contact>)

<Result>: Boolean

True if the contact was modified,
False otherwise. The ErrorOccurred variable is set to True if an error occurred. To find out the error details, use ErrorInfo.
Versions 22 and later

True if the user interface is displayed,
False otherwise.
New in version 22

True if the user interface is displayed,
False otherwise.

True if the user interface is displayed,
False otherwise.

<Contact>: Contact variable

Name of Contact variable corresponding to the contact whose form will be opened. This contact must exist in the database of contacts found on the device.

Caution: Syntax available from version 170069

Opening the form of a contact in edit mode (from Android 2.0, iPhone, iPad, Universal Windows) Hide the details

<Result> = ContactEdit(<Contact>)

<Result>: Boolean

True if the contact was modified,
False otherwise. The ErrorOccurred variable is set to True if an error occurred. To find out the error details, use ErrorInfo.
Versions 22 and later

True if the user interface is displayed,
False otherwise.
New in version 22

True if the user interface is displayed,
False otherwise.

True if the user interface is displayed,
False otherwise.

<Contact>: Contact variable

Name of Contact variable corresponding to the contact whose form will be opened. This contact must exist in the database of contacts found on the device.

Warning
From version 17 (69), this syntax is kept for backward compatibility.

Opening the form of a contact in edit mode (before Android 2.0, iPhone, iPad, Universal Windows) Hide the details

<Result> = ContactEdit([<Contact identifier>])

<Result>: Boolean

True if the contact was modified,
False otherwise. The ErrorOccurred variable is set to True if an error occurs. To find out the error details, use ErrorInfo.
Versions 22 and later

True if the user interface is displayed,
False otherwise.
New in version 22

True if the user interface is displayed,
False otherwise.

True if the user interface is displayed,
False otherwise.

<Contact identifier>: Optional character string

Identifier of contact to edit. This identifier is found in the mContact.ID variable of the Contact structure.
If this parameter is not specified or if it corresponds to an empty string (""), the form of the current contact is displayed.
Reminder: To browse the contacts found on the device, use the following functions: ContactFirst, ContactNext, ContactPrevious and ContactLast.

Remarks

Special cases

ContactEdit is a locking function as long as the form of the contact is not closed by the user.
ContactEdit is a non-locking function.
To update the Contact structure or the Contact variable with the information relative to the contact that was previously edited, use ContactRead.
ContactEdit can be used in the emulator. It cannot be used in the simulator.

Versions 22 and later

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

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.

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.

Related Examples:

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
- ...

Business / UI classification : Business Logic

Component : wd250android.jar