BTStatus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

BTStatus (Function)

In french: BTEtat

Returns the current Bluetooth activation status on the device or asks to be notified when the activation status changes. To enable or disable the Bluetooth on the device, use BTActivate.

Remark: Bluetooth functions are not available in the Android emulator.

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

IF BTStatus() = btDisabled THEN
BTActivate(True)
END

Syntax

Finding out the Bluetooth activation status Hide the details

<Result> = BTStatus()

<Result>: Integer constant

Bluetooth activation status:
btEnabled The Bluetooth is enabled on the device.
btActivationInProgress The Bluetooth is being enabled on the device.
btDeactivationInProgress The Bluetooth is being disabled on the device.
btDisabled The Bluetooth is disabled on the device.
btError The Bluetooth activation status could not be retrieved.

Enabling the notification whenever Bluetooth activation changes Hide the details

BTStatus(<WLanguage procedure>)

<WLanguage procedure>: Procedure name

Name of the WLangage procedure ("callback" procedure) that will be called when the Bluetooth activation status changes on the device.
For more details on this procedure, see Parameters of the procedure used by BTStatus.
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

The call to this function modifies the permissions required by the application.

Required permission: BLUETOOTH

This permission allows the applications to connect to the Bluetooth services.

Component : wd260android.jar