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)

Special cases
Application in the background: Specific case from Android 10
Required application feature

WINDEV

WEBDEV

WINDEV Mobile

Others

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.

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: wd300android.aar