MobileNetworkStatus (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Specific Mobile functions

Functions for phone management

See also

MobileNetworkStatus (Function)

In french: RéseauMobileEtat

Returns the current status of the connection to data on the mobile network or asks to be notified when the status of the connection to data changes.

Notes:

This function cannot be used in the simulator. In this case, it will always return 0.
This function does not affect the Wi-Fi connection but the connection via a telephony operator.

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 22 and later

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

This function is now available for the iPhone/iPad applications.

New in version 22

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

This function is now available for the iPhone/iPad applications.

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

This function is now available for the iPhone/iPad applications.

Example

IF MobileNetworkStatus() = networkConnected THEN
BrowserRunApp("www.windev.com")
END

Syntax

Retrieving the status of the connection to data on the mobile network Hide the details

<Result> = MobileNetworkStatus()

<Result>: Integer constant

Status of the connection to data:
networkConnected Connected.
networkConnectionInProgress Connection in progress.
This constant is not available.
networkDisconnected Disconnected.

Asking to be notified when the status of the connection to data changes on the mobile network Hide the details

<Result> = MobileNetworkStatus(<Procedure Name>)

<Result>: Integer constant

Status of the connection to data:
networkConnected Connected.
networkConnectionInProgress Connection in progress.
This constant is not available.
networkDisconnected Disconnected.

<Procedure Name>: Character string (with or without quotes)

WLangage procedure ("callback" procedure) called when the status of connection to data changes.
This procedure has the following format:

PROCEDURE <Procedure Name>(<New Status>)

<New Status> is an integer constant corresponding to the new status of the connection to data:
networkConnected Connected.
networkConnectionInProgress Connection in progress.
This constant is not available.
networkDisconnected Disconnected.
If this parameter corresponds to an empty string (""), the notifications regarding the change of connection status will not be sent anymore.

Remarks

A change of connection status can occur when the type of network used changes : for example, when switching from 2G network to 3G network (or conversely).

To find out the type of network corresponding to the current connection, use MobileNetworkConnectionInfo.

Related Examples:

Android (WINDEV Mobile): Android System

[ + ] This application is a tutorial example presenting some of the new features of WINDEV Mobile for Android.
The following system functions are used:
- NFC
- Multimedia control
- Brightness
- Volume
- WIFI
- Bluetooth
- Toast
- Progress Bar control
- 9-image mode
- Compass
- Accelerometer
- Camera control
- LED
- Vibrations
- Notifications
- Drawing functions
- Internet

Component : wd240android.jar