EmailRunApp (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Members of the Email structure taken into account

Application in the background: Specific case from Android 10

Related examples

See also

EmailRunApp (Function)

In french: EmailLanceAppli

Starts the native application for sending emails found on the current computer:

Computer running Windows (using the MAPI client),
Mobile device: Android, iPhone, iPad, Universal Windows 10.

The content and the recipients of the email are initialized from the information specified in the Email structure of WLanguage.

Caution:

The application for sending emails found on the current computer must have been configured with a valid account for sending emails (SMTP).
The current directory can be modified according to the configuration of the application for sending emails.

Versions 19 and later

Remarks:

This function is based on the MAPI client installed on the computer ("Simple MAPI" is not sufficient). If the MAPI client is not found, the function searches for the default client among: Microsoft Outlook, Outlook Express, Eudora, IncrediMail, Netscape, Mozilla Thunderbird, Mozilla.
Both the application and the MAPI client must be in 32 bits or in 64 bits. Indeed, if client is a 64-bit application, it will only be seen by the applications compiled in 64 bits (similarly, if client is a 32-bit application, it will only be seen by the applications compiled in 32 bits).

New in version 19

Remarks:

This function is based on the MAPI client installed on the computer ("Simple MAPI" is not sufficient). If the MAPI client is not found, the function searches for the default client among: Microsoft Outlook, Outlook Express, Eudora, IncrediMail, Netscape, Mozilla Thunderbird, Mozilla.
Both the application and the MAPI client must be in 32 bits or in 64 bits. Indeed, if client is a 64-bit application, it will only be seen by the applications compiled in 64 bits (similarly, if client is a 32-bit application, it will only be seen by the applications compiled in 32 bits).

Remarks:

This function is based on the MAPI client installed on the computer ("Simple MAPI" is not sufficient). If the MAPI client is not found, the function searches for the default client among: Microsoft Outlook, Outlook Express, Eudora, IncrediMail, Netscape, Mozilla Thunderbird, Mozilla.
Both the application and the MAPI client must be in 32 bits or in 64 bits. Indeed, if client is a 64-bit application, it will only be seen by the applications compiled in 64 bits (similarly, if client is a 32-bit application, it will only be seen by the applications compiled in 32 bits).

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

New in version 18

This function is now available in Android Widget mode.

Versions 19 and later

This function is now available for WINDEV applications in Windows.

New in version 19

This function is now available for WINDEV applications in Windows.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Send a message with attachment
Email.Recipient[1] = "recipient@email.com"
Email.NbRecipient = 1
Email.Subject = "Subject of message"
Email.Message = "Text of the message"
// Photo.jpg is a file created by the application
Email.Attach[1] = SysDirExternalStorage(1, ssePublicDocument) + [fSep] + "photo.jpg"
Email.NbAttach = 1
EmailRunApp()

Syntax

EmailRunApp()

Remarks

Special cases

A non-fatal error is triggered if no application for sending emails is found on the current computer. To find out whether the application for sending emails failed to start, use the ErrorOccurred variable.
EmailRunApp can be used in the emulator. It cannot be used in the simulator.
The application for sending emails supplied by default in the former versions of Android (<= 1.6) cannot be used to initialize the message with more than one attachment. In this case, only the first attachment described in Email.Attach will be associated with the message.
In Android, if the message to be sent includes attachments, they must be on the shared memory (e.g: SDCard) in order to be accessible to the email client.
To reinitialize the Email structure, use EmailReset.
EmailRunApp is a non-blocking function. The code that follows the call to this function will continue to run as soon as the application for sending emails is started.
There is no way to find out whether the sending of the email was validated by the user.

Members of the Email structure taken into account

Only the following members of the Email structure will be taken into account when initializing the message to send:

Email.Attach
Email.Cc
Email.Bcc
Email.Bcc
Email.Recipient
Email.Message
Email.NbAttach
Email.NbCc
Email.NbBcc
Email.NbBcc
Email.NbRecipient
Email.Subject

The following members are taken into account:

Email.Attach
Email.Cc
Email.Bcc
Email.Recipient
Email.Message
Email.Subject

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.

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

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

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.

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

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

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.

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

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

Related Examples:

Cross-platform examples (WINDEV Mobile): WM Expense Account

[ + ] This example allows you to manage your fees.

Let's see the main features of this application:
- The input of invoices
- Management of foreign currencies
- Inclusion of photo document for the invoices
- Ability to email the expense account
- Ability to track the expense accounts
- ...

Component: wd260com.dll