SMSSend (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.

Managing errors
Differences between GO mode and run time
Required permissions
Folder of SMSs sent
SMS sent by the user

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SMSSend (Function)

In french: SMSEnvoie

Sends an SMS. The characteristics of this SMS have been specified in the SMS structure.

Versions 25 and later

To send SMS messages with an attachment, use SMSRunApp.

New in version 25

To send SMS messages with an attachment, use SMSRunApp.

Versions 15 and later

This function is now available for Android applications.

New in version 15

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

Example

// Initialize the SMS structure for a standard number
SMS.Number = "0610203040"
SMS.Message = "I am sending SMSs with WINDEV Mobile!"

// Send the SMS
ResSend is boolean = SMSSend()

// Error occurred?
IF ResSend = False THEN
Error(ErrorInfo(errMessage))
END

// Initialize the SMS structure for a short number
SMS.Number = "3040"
SMS.Message = "I am sending SMSs with WINDEV Mobile!"
SMS.NumberType = smsNationalNumber

// Send the SMS
ResSend is boolean = SMSSend()

// Error occurred?
IF ResSend = False THEN
Error(ErrorInfo(errMessage))
END

Syntax

<Result> = SMSSend()

<Result>: Boolean

True if the SMS was sent,
False otherwise. To find out the name of the error, use the function ErrorInfo with the constant errMessage.
Versions 15 and later
If SMSSend is run in the main application thread, an hourglass (infinite progress bar) will be displayed when the message is sent. To specify the message to be displayed in the hourglass, use function NextTitle just before function SMSSend.
New in version 15
If SMSSend is run in the main application thread, an hourglass (infinite progress bar) will be displayed when the message is sent. To specify the message to be displayed in the hourglass, use function NextTitle just before function SMSSend.
If SMSSend is run in the main application thread, an hourglass (infinite progress bar) will be displayed when the message is sent. To specify the message to be displayed in the hourglass, use function NextTitle just before function SMSSend.

Remarks

Managing errors

SMSSend generates an error in the following cases:

the recipient number is invalid,
the message to send is too long,
the SMS center is overloaded.
...

Differences between GO mode and run time

In GO mode (simulation on the development computer), a WLanguage error is generated during the call to SMSSend.

The differences between GO mode (simulator) and runtime are presented in Differences between GO mode and runtime.

The SMS functions can be used during a GO on the Android emulator. To simulate the sending of SMS messages to the emulator, see the documentation of the Android SDK : https://developer.android.com/studio/run/emulator#console

Required permissions

The call to this function modifies the permissions required by the application.
Required permission: SEND_SMS

Folder of SMSs sent

The sms/sent folder that can be found on some Android devices is not automatically filled when an SMS is sent.

SMS sent by the user

If the SMS must be actually sent by the user from the native application of the device (Android or iPhone/iPad), use SMSRunApp.

Related Examples:

Mobile (WINDEV Mobile): Pocket Managing Contacts

[ + ] This example presents the management of contacts in Pocket PC.
The following topics will be presented in this example:
1/ the loopers
2/ the use of queries
3/ sending SMSs
4/ sending emails
5/ the phone call.

Component: wp260com.dll