ContactCreate (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

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 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 (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 more details on 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 of the new 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 more details on 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 blocking function until the user validates or cancels the contact creation window.
Versions 22 and later
ContactCreate is a non-blocking function.
New in version 22
ContactCreate is a non-blocking function.
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 by programming (without opening any window):

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

Versions 25 and later

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.

New in version 25

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.

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.

Versions 22 and later

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.

New in version 22

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.

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