ContactEdit (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Communication

Contact functions (Lotus Notes or Android/iPhone/iPad)

ContactEdit

Presentation

Example

Special cases

Application in the background: Specific case from Android 10

Required application feature

See also

ContactEdit (Function)

In french: ContactEdite

Opens the form of a contact in edit mode in the device's native contacts application (Android, iPhone, iPad, Universal Windows).

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)

Syntax

Opening a contact form in edit mode Hide the details

<Result> = ContactEdit(<Contact>)

<Result>: Boolean

True if the contact was modified,
False otherwise. If an error occurs, the ErrorOccurred variable is set to True. To get more details on the error, use ErrorInfo.

True if the user interface is displayed,
False otherwise.

<Contact>: Contact variable

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

Remarks

Special cases

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

Application in the background: Specific case from Android 10

From Android 10, it is no longer possible to open a window when the application is in the background.

ContactEdit can open a window. If this function is used while the application is in the background, a fatal error will occur.

Tips:

It is possible to determine if the application is in the background using InBackgroundMode.
If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). The application will be brought back to the foreground when the notification is clicked, if the ActivateApplication property is set to True. You can also open a window from the procedure passed to the ActionClick property.

For more details, see Android 10: Behavior of applications in the background.

Required application feature

When this function is used, an application feature is declared in the application generation wizard.

Required feature: Contacts

This feature allows the applications to access the contacts.

Business / UI classification: Business Logic

Component: wd280android.aar