ContactCreate (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
Creating a contact (without using the creation window)
Application in the background: Specific case from Android 10
Required application feature

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ContactCreate (Function)

In french: ContactCrée

Displays the window for contact creation of the native application for contact management found on the device (Android, iPhone or iPad, Universal Windows).

Example

// Create a contact and initialize the Contact structure
IF ContactCreate() = True THEN
Info(StringBuild("The contact %1 was added to your list of contacts: ", ...
mContact.Name))
END

gCurrentContact is Contact
garrContacts is array of Contact

// Create a contact in the default window
IF ContactCreate() = True THEN
// Refreshes the list of contacts displayed in a Looper control
nIndex is int = LOOP_CONTACTS
LooperDeleteAll(LOOP_CONTACTS)
// List of contacts
garrContacts = ContactList()
// Sort the contacts
ArraySort(garrContacts, asMember, "+Name")
// Add into the looper
FOR EACH tContact OF garrContacts
LooperAddLine(LOOP_CONTACTS, tContact..LastName, tContact..FirstName)
END
END

Syntax

Creating a contact and initializing the Contact variable Hide the details

<Result> = ContactCreate([<Contact>])

<Result>: Boolean

True if a contact was created,
False otherwise. 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 containing the data of the new contact.

Remarks

Special cases

If the user creates a new contact, the Contact structure or the Contact variable is automatically populated with the details of this new contact.
ContactCreate is a blocking function until the user validates or cancels the contact creation window.
ContactCreate is a non-blocking function.
ContactCreate can be used in the emulator. It cannot be used in the simulator.

Creating a contact (without using the creation window)

To create a new contact programmatically (without opening any window):

Describe the contact using the Contact variable.
Use the ContactAdd function.

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.

ContactCreate 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