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

Help / WLanguage / WLanguage functions / Mobile specific functions / SMS functions

Differences between GO mode and runtime
Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SMSFirst (Function)

In french: SMSPremier

Reads the first SMS message stored on the Android phone. The characteristics of this SMS are contained in the SMS structure.

Note: Only SMS messages stored in the phone's memory can be handled by the SMS functions.

Example

// Nombre de SMS stockés en mémoire
LIB_NbSMS = "Vous avez " + SMSNbMessage(smsMemory) + " messages."
 
// Lecture du 1er SMS stocké en mémoire
ResLecture is boolean = SMSFirst(smsMemory)
 
WHILE ResLecture = True
	// Affichage des caractéristiques de ce SMS dans un champ Table :
	// la variable SMS est automatiquement mise à jour
	TableAddLine(TABLE_TableSMS, SMS.Subscript, SMS.Message, SMS.Number, SMS.ReceiveDate)
	// Lecture des autres SMS
	ResLecture = SMSNext(smsMemory)
END

Syntax

<Result> = SMSFirst(<Location>)

<Result>: Boolean

True if the SMS was read. SMS.ReceiveDate, SMS.Index, SMS.Message, SMS.Number and SMS.NumberType are automatically filled. For more details, see SMS structure.
False otherwise. To get more details on the error, use ErrorInfo with the errMessage constant.

<Location>: Integer constant

Location of SMS to read:
smsMemory SMS stored in the device memory.

Remarks

Differences between GO mode and runtime

A WLanguage error is raised when SMSFirst is called in test mode (GO) (simulation on the development computer).

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

This function changes the permissions required by the application.

Permission required: READ_SMS

Business / UI classification: Business Logic

Component: wd300android.aar