ContactCreate (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

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

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ContactCreate (Function)

In french: ContactCrée

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

Example

// Création d'un contact et initialisation de la structure Contact
IF ContactCreate() = True THEN
	Info(StringBuild("Le contact %1 a été ajouté à la liste de vos contacts : ", ...
		 mContact.Name))
END

gContactEnCours is Contact
gtabContacts is array of Contact

// Création d'un contact dans la fenêtre par défaut
IF ContactCreate() = True THEN
	// Rafraîchit la liste des contacts affichée dans un champ Zone répétée
	nIndice is int = ZR_CONTACTS
	LooperDeleteAll(ZR_CONTACTS)
	// Liste des contacts
	gtabContacts = ContactList()
	// Tri des contacts
	ArraySort(gtabContacts, asMember, "+Nom")
	// Ajout dans la zone répétée
	FOR EACH tContact OF gtabContacts
		LooperAddLine(ZR_CONTACTS, tContact..Name, tContact..FirstName)
	END
END

Syntax

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

<Result>: Boolean

True if a contact was created,
False otherwise. To get more details on the error, use ErrorInfo.

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

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

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