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.

Special cases
Creating a contact (without using the creation window)
Application in the background: Android 10 specific case
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).

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available for iPhone/iPad applications.

New in version 18

This function is now available in Android Widget mode.

This function is now available for iPhone/iPad applications.

This function is now available in Android Widget mode.

This function is now available for 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

// 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 HEX@ of the contacts displayed in an Looper control
nSubscript 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 (from Android 2.0, iPhone, iPad, Universal Windows) Hide the details

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

<Result>: Boolean

True if a contact was created,
False otherwise. To get the details of the error, 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 the Contact variable containing the data corresponding to the created contact.

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

Creating a contact and initializing the Contact variable (before Android 2.0, iPhone, iPad, Universal Windows) Hide the details

<Result> = ContactCreate()

<Result>: Boolean

True if a contact was created,
False otherwise. To get the details of the error, 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.

Remarks

Special cases

If the user creates a new contact, the Contact structure or the Contact variable is automatically filled with the information relative to this new contact.
ContactCreate is a locking function until the user validates or cancels the window for contact creation.
Versions 22 and later
ContactCreate is a non-locking function.
New in version 22
ContactCreate is a non-locking function.
ContactCreate is a non-locking 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 by programming (without opening any window):

Describe the contact in the Contact structure or in the Contact variable.
Use ContactAdd.

Versions 25 and later

Application in the background: Android 10 specific case

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). When the notification is clicked on, the application will be brought back to the foreground if ..ActivateApplication is set to True. It is also possible to open a window from the procedure passed to ..ActionClick.

See Android 10: Behavior of applications in the background for more details.

New in version 25

Application in the background: Android 10 specific case

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). When the notification is clicked on, the application will be brought back to the foreground if ..ActivateApplication is set to True. It is also possible to open a window from the procedure passed to ..ActionClick.

See Android 10: Behavior of applications in the background for more details.

Application in the background: Android 10 specific case

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). When the notification is clicked on, the application will be brought back to the foreground if ..ActivateApplication is set to True. It is also possible to open a window from the procedure passed to ..ActionClick.

See Android 10: Behavior of applications in the background for more details.

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 : wd260android.jar