MobileNetworkConnectionInfo (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Specific Mobile functions

Functions for phone management

MobileNetworkConnectionInfo

Presentation

Example

WiFi connection information

Related examples

See also

MobileNetworkConnectionInfo (Function)

In french: RéseauMobileInfoConnexion

Returns information regarding the current connection to data on the mobile network.

Remark: This function cannot be used in the simulator and it will return 0 in this case.

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 iPhone/iPad applications.

New in version 22

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

This function is now available for iPhone/iPad applications.

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

This function is now available for iPhone/iPad applications.

Example

// Activation of the Wi-Fi if the signal intensity is strong enough to access the data// via the mobile network
IF MobileNetworkConnectionInfo(networkGSMSignal) <= 20 _AND_ WiFiStatus() <> wifiEnabled THEN
IF YesNo("The intensity of the GSM signal is not sufficient. Enable the Wi-Fi?") THEN
WiFiActivate()
END
END

Syntax

<Result> = MobileNetworkConnectionInfo(<Type of information>)

<Result>: Character string

Requested information.
If several types of information are requested, each type of information is separated by a CR character (Carriage Return).
The order in which the information is returned (if requested) is as follows:
<Type of network>
<Operator>
<GSM signal>
<Roaming>
<Plane mode>

<Type of information>: Integer

Requested information:
networkRoaming Roaming mode of data.
If this information is requested, <Result> is set to:
1 if the current connection uses the data roaming
0 otherwise.
This constant is not available.
networkAirPlaneMode Management of plane mode.
If this information is requested, <Result> is set to:
1 if the device is in plane mode.
0 otherwise.
This constant is not available.
networkOperator Name of network operator used.
Depending on the type of network or if the plane mode is enabled, this information may not be specified.
If no SIM card is found, this information may correspond to an operator name if the phone is "Sim-locked".
networkGSMSignal Intensity of the GSM signal included between 0 (no signal) and 100 (optimum signal).
This constant is not available.
networkType Type of network used to access the data on the mobile network.
Roaming mode of data.
If this information is requested, <Result> is set to:
network2G: 2G network
networkEdge: Edge network
network3G: 3G network
network4G: 4G network
networkUnknown: Unknown network (or SIM card not found).

Remarks

WiFi connection information

To get information about the WiFi connection, use WiFiConnectionInfo.

Versions 25 and later

Required permissions
The call to this function modifies the permissions required by the application.
The ACCESS_COARSE_LOCATION permission is added: this permission allows an application to access an undefined location (Cell-ID, WiFi).

New in version 25

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 : wd250android.jar