WiFiStatus (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 / Communication / WiFi functions

Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

WiFiStatus (Function)

In french: WiFiEtat

Returns the current activation status of Wi-Fi on the device or asks to be notified when the activation status of Wi-Fi changes.

Remarks:

To enable or disable the Wi-Fi on the device, use WiFiActivate.
The Wi-Fi access is not available in the Android emulator.
Please note: This feature is available only up to Android 9.. From Android 10, this information is no longer available. Using this function causes a fatal error. It is recommended to test the Android version used via SysAndroidVersion.

Example

IF WiFiStatus() = wifiDisabled THEN
	WiFiActivate(True)
END

Syntax

Finding out the current activation status of Wi-Fi on the current computer Hide the details

<Result> = WiFiStatus()

<Result>: Integer

Current activation status of Wi-Fi:
wifiActivationInProgress The Wi-Fi is being enabled on the device.
This constant is not available.
wifiDeactivationInProgress The Wi-Fi is being disabled on the device.
This constant is not available.
wifiDisabled The Wi-Fi is disabled on the device.
wifiEnabled The Wi-Fi is enabled on the device.
wifiError The activation status of Wi-Fi cannot be retrieved.
This constant does not correspond to a possible option.

Enabling the notification for changes of Wi-Fi activation Hide the details

WiFiStatus(<WLanguage procedure>)

<WLanguage procedure>: Procedure name

WLanguage procedure ("callback" procedure) called when the activation status of Wi-Fi changes on the device.
This procedure has the following format:
PROCEDURE <Procedure name> (<New status>, <Former status>)
where:
<New status> is an integer corresponding to the new activation status of Wi-Fi on the device
<Former status> is an integer corresponding to the activation status of Wi-Fi on the device before the change of status.
The parameters of this procedure are optional. There is no need to pass parameters to this procedure. Indeed, these parameters are automatically filled during each call.
If this parameter corresponds to an empty string (""), the notifications will not be sent anymore when the status changes. The function has no effect if no notification request was performed.

Remarks

Required permissions

This function changes the permissions required by the application.

Permission required: ACCESS_WIFI_STATE

This permission allows the applications to access information regarding the Wi-Fi networks.

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: WDJS.DLL