PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Special cases
  • Members of the Email structure taken into account
  • Application in the background: Android 10 specific case
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
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 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 18 and later
Android Widget This function is now available in Android Widget mode.
New in version 18
Android Widget This function is now available in Android Widget mode.
Android Widget This function is now available in Android Widget mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App 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"
Email.Attach[1] = "/sdcard/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.
  • AndroidAndroid Widget iPhone/iPad EmailRunApp can be used in the emulator. It cannot be used in the simulator.
  • AndroidAndroid Widget 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.
  • AndroidAndroid Widget In Android, if the message to send includes attachments, these ones must be found on the shared memory (example: the SDCard) in order to be accessible to the email client.
  • To reinitialize the Email structure, use EmailReset.
  • EmailRunApp is a non-locking 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

Android 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
iPhone/iPadUniversal Windows 10 App The following members are taken into account:
  • Email.Attach
  • Email.Cc
  • Email.Bcc
  • Email.Recipient
  • Email.Message
  • Email.Subject
Versions 25 and later
AndroidAndroid Widget

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.
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). 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.
New in version 25
AndroidAndroid Widget

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

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.
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). 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.
Related Examples:
WM Expense Account 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 : wd250com.dll
Minimum version required
  • Version 16
This page is also available for…
Comments
Video EmailRunApp
https://youtu.be/ahc4D0G_nD8


https://windevdesenvolvimento.blogspot.com/2019/07/dicas-2183-windev-webdev-mobile-webdev.html
amarildo
06 Jul. 2019
Video EmailRunApp
ps://youtu.be/fm4ZFuPNpB8

https://windevdesenvolvimento.blogspot.com/2019/02/dicas-2028-windev-mobile-aula-109.html

Email.Recipient[1] = "amarildo.matos@gmail.com "
Email.NbRecipient = 1
Email.Subject = "Assunto"
Email.Message = "messagem"
//Email.Attach[1] = "/sdcard/photo.jpg"
//Email.NbAttach = 1
EmailRunApp()
amarildo
27 Feb. 2019