SMSRunApp (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Elements taken into account in the SMS structure
Error cases
Application in the background: Specific case from Android 10

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SMSRunApp (Function)

In french: SMSLanceAppli

Starts the native application for sending SMSs found on the device (Android or iPhone/iPad). The content and the recipients of the SMS are initialized from the information specified in the SMS structure of WLanguage.

Caution: The SMS is not sent. Only the controls of the application for sending SMSs are initialized.

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

SMS.Number = "0610203040"
SMS.Message = "I am sending SMSs with WINDEV Mobile!"
SMSRunApp()

Syntax

SMSRunApp()

Remarks

Elements taken into account in the SMS structure

Only the SMS.Number and SMS.Message variables are taken into account.
Only the following variables are taken into account:
- SMS.Number,
- SMS.Message,
- Versions 25 and later
  SMS.Attachment.
  New in version 25
  SMS.Attachment.
  SMS.Attachment.
- SMS.NumberType and SMS.CountryPrefix are taken into account.

For more details, consult the SMS structure of WLanguage.

Error cases

If no native application for sending SMSs was found on the device, the ErrorOccurred variable will be set to True after the call to the function. To get the details of the error, use ErrorInfo.

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.

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

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

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

[ + ] This application is an example of some of the features of WINDEV Mobile available for Android/iOS.
The following system functions are used:
- NFC
- Multimedia control
- Brightness
- Volume
- Wi-Fi
- Bluetooth
- Toast
- Compass
- Accelerometer
- Camera control
- LED
- Vibration
- Notifications
- Drawing functions
- Internet

Component: wd270android.aar